# @evref-bl/pharo-launcher-mcp 中文文档

规范地址：https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/

版本：0\.4\.1
npm 元数据更新时间：2026-11-10T19:20:17.666Z
中文译文更新时间：2026-11-14T02:44:50.494Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40evref-bl/pharo-launcher-mcp
原文对照：https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/?lang=original
项目主页：https://github.com/Evref-BL/pharo-launcher-mcp#readme
源码仓库：https://github.com/Evref-BL/pharo-launcher-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：347 kB，76 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：1 个
- 首次发布：2026-04-27T01:09:09.497Z
- 最新版本发布：2026-11-10T19:20:17.260Z
- 近 30 天下载量：2705（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

MCP服务器用于控制 Pharo 启动器的图像,模板,VMs,和进程.

## 安装

```sh
npm install @evref-bl/pharo-launcher-mcp
```

也可以使用：`pnpm add @evref-bl/pharo-launcher-mcp`、`yarn add @evref-bl/pharo-launcher-mcp`、`bun add @evref-bl/pharo-launcher-mcp`

## README

# 法罗-发射器-mcp

pharo-launder-mcp 是用于控制来自主机的 Pharo 发射器的 MCP 服务器 进程.

它暴露出 Pharo 启动器的图像,模板, VM, 以及作为 MCP 的处理操作 工具。 MCP 客户端可以询问它解决了何种启动器安装, 列出 模板、创建或复制图像、启动图像、包图像、检查运行 Pharo 处理,并删除调用器拥有的图像或 VM.

服务器在目标图像外工作. 它不安装代码在这些 图像,保持工程状态,或者决定哪些图像安全可变. 这是 高层工具在需要混凝土时可以调用的发射管边界 图像或进程动作.

## 安装

所需经费:

-   节点js 22.12.0或更新
-   `npm` 财务报告和审定财务报表 `npx`
-   安装在主机上的 Pharo 发射器

从 npm 安装 :

```sh
npm install @evref-bl/pharo-launcher-mcp
```

通过 stdio 运行 MCP 服务器 :

```sh
npx @evref-bl/pharo-launcher-mcp
```

该套件还提供了 `pharo-launcher-mcp` 安装在 项目或全球范围.

## 当作图书馆用

节点呼叫器不需要协议 。 这些工具是功能:

```js
import { openPharoLauncher } from "@evref-bl/pharo-launcher-mcp/launcher";

const launcher = openPharoLauncher();
const running = await launcher.listProcesses();
const images = await launcher.listImages({ nameFilter: "Task" });
```

每一次通话都直接回答正常发射装置的发射结果,并回答其 `ok`, (中文(简体) ), `data`, (中文(简体) ), `diagnostic` 财务报告和审定财务报表 `command` 字段,而不是 MCP 中的 JSON 调用者解析的文本块.

TypeScript 调用器获得这些形状,所以结果不必 在离开途中再次描述:

```ts
import type {
  LauncherCommandResult,
  LauncherImage,
  LauncherProcess,
  LauncherTemplate,
} from "@evref-bl/pharo-launcher-mcp/launcher";
```

范围是一个配置,而不是一个过程。 一个在档案通行证内工作的呼叫员 而不是催生一个过程来控制这些 变量 :

```js
const scoped = openPharoLauncher({
  env: { PHARO_LAUNCHER_MCP_PROFILE: "isolated", PHARO_LAUNCHER_MCP_STATE_ROOT: stateRoot },
});
```

MCP服务器是同一功能的适配器,所以是嵌入它的主机 而不是产卵 进口,相反:

```js
import { callTool, createServer } from "@evref-bl/pharo-launcher-mcp";
import { loadPharoLauncherConfig } from "@evref-bl/pharo-launcher-mcp/config";
import { defaultLauncherDir } from "@evref-bl/pharo-launcher-mcp/platform";
```

可执行文件作为命令可以达到,而不是导入:加载它开始 a 服务器在stdio.

## 术语

-   A 类 **Pharo 发射器安装** 是应用程序或数据目录, VM 可执行, 控制图像,以及用于运行"发射"命令的发射包.
-   A 类 **发射器状态范围** 是图像, VM, 模板源, init-script,以及受启动器命令影响的日志目录.
-   **无显示模式** 使用用户正常的 Pharo 启动器安装和 国家范围.
-   A 类 **法罗-发射器-mcp 剖面** 选择一个明确的孤立状态范围 通过环境变量.
-   A 类 **发射器工具结果** 是大多数返回的普通 JSON 信封 工具。 它包括可用时的解析数据、 生 stdout/ stderr、 解析器 状态、命令持续时间、退出代码和超时状态.

## 快速启动

检查服务器将使用何种安装而不引用 Pharo 启动器 :

```sh
npx @evref-bl/pharo-launcher-mcp --health
```

如果发现路径不正确,请明确设置路径:

```sh
PHARO_LAUNCHER_DIR="/path/to/Pharo Launcher"
PHARO_LAUNCHER_VM="/path/to/pharo"
PHARO_LAUNCHER_IMAGE="/path/to/PharoLauncher.image"
npx @evref-bl/pharo-launcher-mcp --health
```

配置 MCP 客户端启动 stdio 服务器 。 通用 MCP 配置 看起来像这样:

```json
{
  "mcpServers": {
    "pharo-launcher": {
      "command": "npx",
      "args": ["-y", "@evref-bl/pharo-launcher-mcp"]
    }
  }
}
```

一旦连接,请从这些工具开始:

```text
pharo_launcher_config
pharo_launcher_image_list
pharo_launcher_template_list
```

`pharo_launcher_config` 只检查已解析的配置;另两个 越过发射机的边界.

在连接前检查安装是可执行文件的工作,而不是一个 {\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}工具的 {\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}我用工具. `pharo-launcher-mcp --health`, (中文(简体) ), `--version-check`, (中文(简体) ), `--validate-installation` 财务报告和审定财务报表 `--probe-images` 每个打印 JSON 并退出.

## 配置文件快速启动

当自动化或测试需要孤立的发射器状态范围时使用配置文件:

```sh
PHARO_LAUNCHER_MCP_PROFILE=isolated
PHARO_LAUNCHER_MCP_STATE_ROOT=/path/to/launcher-profile
npx @evref-bl/pharo-launcher-mcp --health
```

在配置模式中,pharo-launker-mcp将发射装置控制图像复制到 需要时配置根, 创建配置目录, 并编写启动器 CLI 对图像、VMs、模板、init脚本和日志进行指点的配置 简介。 不描述模式不活动, 除非配置环境之一 变量已经设置.

读取 [配置模式](https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/docs/user/profile-mode.md) ưμ㼯a 图像创建, 发布, 或清理 .

## 共同工作流程

列出可用的模板 :

```text
pharo_launcher_template_update
pharo_launcher_template_list
```

从模板创建图像 :

```json
{
  "tool": "pharo_launcher_image_create",
  "arguments": {
    "templateName": "Pharo 13.0 - 64bit",
    "newImageName": "sample-130",
    "noLaunch": true
  }
}
```

复制图像 :

```json
{
  "tool": "pharo_launcher_image_copy",
  "arguments": {
    "imageName": "sample-130",
    "newImageName": "sample-130-copy"
  }
}
```

启动图像 :

```json
{
  "tool": "pharo_launcher_image_start",
  "arguments": {
    "imageName": "sample-130-copy",
    "displayMode": "headless",
    "detached": true
  }
}
```

## 安全模型

变异工具是明确的,并列出它们的行为。 没有 确认论据: 调用工具是决定调用它, 而秒 同一意图的拼写不会保护任何东西.

保护某样东西的是目标. `pharo_launcher_process_kill` 需要准确的其中之一 `pid` 或者说 `imageName`,然后一个 PID 停止此进程 一个人 更喜欢PID 一个分离的发射器返回 当清理一个发射你 拥有的.

`pharo_launcher_image_create` 财务报告和审定财务报表 `pharo_launcher_image_copy` 验证目标 图像在启动器报告成功后 。 如果目标图像无法列出 已检查, MCP 结果在命令输出和校验上都存在错误 诊断.

## 文档

-   [开始](https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/docs/user/getting-started.md) 覆盖安装, 环境发现,MCP客户端设置,以及首次健康检查.
-   [配置模式](https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/docs/user/profile-mode.md) 解释无可显示模式, 孤立 剖面图、剖面路径、生成的配置和交叉图像 copy.
-   [工具参考](https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/docs/reference/tools.md) 列出 MCP 工具、参数, 结果信封和特殊行为.
-   [解决问题](https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/docs/troubleshooting.md) 普通设置和活的启动器 具体检查失败.
-   [发展](https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/docs/development.md) 覆盖源布局,测试,局部探测器, 和现场测试边界.
-   [清理钩子边界](https://npmcn.com/package/%40evref-bl/pharo-launcher-mcp/docs/cleanup-hook-boundary.md) 描述状态, 暂停,停止,并清理合同 呼叫者管理现场检查.

## 来源开发

```sh
npm install
npm run check
```

`npm run check` 运行类型检查、构建和单位测试。 现场融合测试 它们是单独的,因为它们引用了当地Pharo发射装置:

```sh
npm run test:integration
```

## 常见问题

### @evref-bl/pharo-launcher-mcp 是什么？

MCP服务器用于控制 Pharo 启动器的图像,模板,VMs,和进程\.

### 如何安装 @evref-bl/pharo-launcher-mcp？

在项目目录运行 npm install @evref-bl/pharo-launcher-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pharo-launcher-mcp，可以用 npx pharo-launcher-mcp 直接运行。

### @evref-bl/pharo-launcher-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @evref-bl/pharo-launcher-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @evref-bl/pharo-launcher-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @evref-bl/pharo-launcher-mcp 可以商用吗？

@evref-bl/pharo-launcher-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @evref-bl/pharo-launcher-mcp 的下载量有多少？

根据 npm 官方下载统计，@evref-bl/pharo-launcher-mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,705 次，日均约 90 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @evref-bl/pharo-launcher-mcp 还在维护吗？

最新版本 0\.4\.1 发布于 2026/11/11（3 天前）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/04/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。