@zenaigc/zenmcp 0.1.8 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/INSTALL.md +83 -55
- package/dist/src/doctor.js +85 -2
- package/dist/src/mcp/server.js +1 -1
- package/package.json +1 -1
package/INSTALL.md
CHANGED
|
@@ -1,106 +1,134 @@
|
|
|
1
1
|
# ZenMCP Agent 自助安装指南
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
请按「识别唯一宿主 → 环境检查 → 单次安装与自检 → 能力匹配配置 → 绑 Key → Skill → 诚实验收」流程执行。**平台 Key 不得在对话、命令行参数或日志中出现明文。**
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 交互要求与红线
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
7
|
+
- **单宿主铁律(最高优先级)**:先确认当前对话所在的**唯一目标软件**(若会话存在 `mcp_superone_*` / `widget_show` 等工具,即使底层模型/引擎是 Claude、Codex、Grok、DeepSeek 或 Cursor,目标宿主一律为 **SuperOne**)。除非用户明确要求配置其他软件,**严禁扫描、询问或修改本机其他 AI 客户端的配置文件、软链或技能目录**。
|
|
8
|
+
- **五步进度清单**:向用户展示并随真实进度更新:`环境检查 → 安装 → 客户端配置 → 绑定平台 Key → 启用与验证`。
|
|
9
|
+
- **诚实勾选原则**:只有当前会话已实际挂载 `zenmcp` 工具并成功调用 `account_status` 时,最后一项才可标 `[x]`;凡需用户在界面手动粘贴配置或重载/新开会话才能生效时,对应项必须保持 `[ ] 待粘贴/重载后生效`,**严禁在终端手搓脚本调用 `server.js` 冒充会话已连通**。
|
|
10
|
+
- **最少打扰与隐私脱敏**:
|
|
11
|
+
- 缺失系统依赖只合并询问一次,列出所有缺项并提供「全部安装 / 我自行安装」选项(有选项式提问工具时优先使用)。
|
|
12
|
+
- 将 `zenmcp-doctor` 输出整理成「通过 / 缺失」表格,不直接贴大段原始 JSON;`config` 三项(`ZENMCP_BASE_URL`、`ZENMCP_TOKEN`、`credentials_file`)只说明是否已配置,不展示值或凭据文件路径。
|
|
13
|
+
- Key 不进入聊天:引导通过 `zenmcp-setup` 本机网页或终端 `zenmcp login` 隐藏输入保存;若用户自行粘贴到聊天,不回显并提示立即前往账户页撤销重建。
|
|
12
14
|
|
|
13
15
|
| 异常 | 下一步 |
|
|
14
16
|
| --- | --- |
|
|
15
|
-
| 命令找不到 |
|
|
16
|
-
| `token_missing` | 按第
|
|
17
|
-
| `invalid_credential` |
|
|
17
|
+
| 命令找不到 | 改用 `zenmcp-doctor` 返回的 `node_path` 与 `server_entry` 绝对路径(`command` 填 `node_path`,`args` 填 `[server_entry]`)。 |
|
|
18
|
+
| `token_missing` | 按第 4 步在账户页创建 Key,通过本机 `zenmcp-setup` 或终端 `zenmcp login` 保存;保存后免重启客户端即可重试 `account_status`。 |
|
|
19
|
+
| `invalid_credential` | 查看报错提示的凭据来源:来自本机凭据文件时重新执行登录保存即可;来自 `env.ZENMCP_TOKEN`(优先于凭据文件)时,移除或更新客户端配置中的 `env.ZENMCP_TOKEN` 后重载客户端。 |
|
|
18
20
|
| 网络失败 | 检查网络连接及客户端能否访问 https://api.zenaigc.com,恢复后重试只读账户查询。 |
|
|
19
21
|
|
|
20
|
-
## 1.
|
|
22
|
+
## 1. 识别当前宿主与检查本机环境
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
结合自身系统提示词/内置工具列表、当前工作目录路径及环境变量确认唯一宿主(可参考第 2 步 `zenmcp-doctor` 的 `runtime.detected_host_hint`,但以“外层对话软件优先于底层引擎”为准)。
|
|
23
25
|
|
|
24
|
-
|
|
26
|
+
随后检查依赖:`node -v`(确认 Node.js ≥ 22)、`ffmpeg -version`、`ffprobe -version`,并检查 Google Chrome 已安装且可启动。
|
|
25
27
|
|
|
26
|
-
|
|
27
|
-
- Windows:使用 `winget`,例如 `winget install OpenJS.NodeJS.LTS`、`winget install Gyan.FFmpeg`、`winget install Google.Chrome`。
|
|
28
|
-
- Linux:使用 `apt` 安装 Node.js、FFmpeg 和 Google Chrome(Chrome 使用官方 deb 包交给 `apt` 安装)。先检查 apt 软件源提供的 Node.js 是否 ≥ 22;不满足时先说明需要配置兼容的软件源,获得用户同意后再处理。
|
|
28
|
+
有缺失时,先合并告知缺项并征得用户同意,再按系统安装:
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
- macOS:`brew install node@22 ffmpeg`、`brew install --cask google-chrome`(确保 Node.js 在 `PATH` 中)。
|
|
31
|
+
- Windows:`winget install OpenJS.NodeJS.LTS`、`winget install Gyan.FFmpeg`、`winget install Google.Chrome`。
|
|
32
|
+
- Linux:使用 `apt` 安装 Node.js、FFmpeg 与 Google Chrome(使用官方 deb 包交给 `apt` 安装);若默认源 Node.js < 22,先说明需要配置兼容软件源并获同意后再处理。
|
|
31
33
|
|
|
32
|
-
|
|
34
|
+
安装后重新打开终端或刷新环境并复查;FFmpeg 应同时提供 `ffprobe`。
|
|
35
|
+
|
|
36
|
+
## 2. 安装 ZenMCP 并运行单次自检
|
|
37
|
+
|
|
38
|
+
优先指定 npm 官方源安装,避免国内镜像源滞后在旧版本(仅当官方源不可达时回退默认 `npm install -g @zenaigc/zenmcp`):
|
|
33
39
|
|
|
34
40
|
```bash
|
|
35
|
-
npm install -g @zenaigc/zenmcp
|
|
41
|
+
npm install -g @zenaigc/zenmcp --registry=https://registry.npmjs.org
|
|
36
42
|
```
|
|
37
43
|
|
|
38
|
-
|
|
44
|
+
随后运行一次本机自检:
|
|
39
45
|
|
|
40
46
|
```bash
|
|
41
47
|
zenmcp-doctor
|
|
42
48
|
```
|
|
43
49
|
|
|
44
|
-
|
|
50
|
+
- 确认 `"ok": true`(否则按缺项修复后重跑)。未绑 Key 前 `config` 中 `ZENMCP_BASE_URL`、`ZENMCP_TOKEN` 与 `credentials_file` 为 `false` 属正常,不影响自检。
|
|
51
|
+
- 从返回的 `runtime` 读取 `node_path`、`server_entry`、`setup_bin`、`skill_dir`、`in_app_sandbox`、`headless_or_ssh` 与 `detected_host_hint`(若遇旧版尚无 `runtime` 字段,用 `command -v node` / `where.exe node` 与 `npm root -g` 定位 `<npm root -g>/@zenaigc/zenmcp/dist/src/mcp/server.js` 等路径)。
|
|
52
|
+
- **沙盒免双装规则**:当 `in_app_sandbox` 为 `true`(如豆包电脑版内置 `sandbox_runtime`)时,**禁止再往用户的 `nvm`、Homebrew 或系统目录重复安装第二遍**;后续统一使用 `runtime.node_path` 与 `runtime.server_entry` 绝对路径,GUI 与沙盒均可直接独立启动。
|
|
45
53
|
|
|
46
|
-
##
|
|
54
|
+
## 3. 按宿主的 MCP 注册能力配置当前软件
|
|
47
55
|
|
|
48
|
-
|
|
56
|
+
GUI 客户端常不继承终端 `nvm` / Homebrew 的 `PATH`,配置一律使用**无密钥绝对路径**(内置默认地址 `https://api.zenaigc.com/api/v1`,无需配置 `ZENMCP_BASE_URL`):
|
|
49
57
|
|
|
50
58
|
```json
|
|
51
59
|
{
|
|
52
60
|
"mcpServers": {
|
|
53
61
|
"zenmcp": {
|
|
54
|
-
"command": "
|
|
62
|
+
"command": "<node_path>",
|
|
63
|
+
"args": ["<server_entry>"]
|
|
55
64
|
}
|
|
56
65
|
}
|
|
57
66
|
}
|
|
58
67
|
```
|
|
59
68
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
- **SuperOne**:在其 MCP 设置中添加上述配置块。
|
|
63
|
-
- **Claude Code**:运行 `claude mcp add zenmcp -s user -- zenmcp`。
|
|
64
|
-
- **WorkBuddy**:写入 `~/.workbuddy/mcp.json`,或在客户端 MCP 设置中添加上述配置块。
|
|
65
|
-
- **豆包电脑版**:左侧「技能·连接器」→ 添加 MCP,填入上述配置块,或命令填 `zenmcp`。
|
|
66
|
-
- **Claude Desktop**:在 `claude_desktop_config.json` 中合并添加上述配置块。
|
|
67
|
-
|
|
68
|
-
命令查找失败时按以下顺序处理:
|
|
69
|
+
### 三种注册模式
|
|
69
70
|
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
71
|
+
- **M1(原生 CLI 注册)**:调用当前宿主的官方 CLI 命令原子写入用户级配置。
|
|
72
|
+
- **M2(本地配置文件备份合并)**:仅操作当前宿主自己的配置文件(已有文件先备份),按其语法方言合并 `zenmcp` 节点,保留其他全部已有配置与服务。
|
|
73
|
+
- **M3(封闭存储 / 界面手动添加)**:当前宿主无公开外部配置文件时,**不改其他客户端文件、不用桌面自动化点击宿主自身窗口**;向用户输出填好真实 `<node_path>` 与 `<server_entry>` 的配置块并指明界面入口,清单对应项保持 `[ ] 待你在界面粘贴启用`。
|
|
73
74
|
|
|
74
|
-
|
|
75
|
+
### 主流宿主能力匹配表
|
|
75
76
|
|
|
76
|
-
|
|
77
|
+
| 宿主软件 | MCP 注册模式与目标位置 / 语法方言 | Skill 模式(第 5 步) |
|
|
78
|
+
| --- | --- | --- |
|
|
79
|
+
| **SuperOne** | **M2 / M3**:在其 MCP 设置中添加标准 `mcpServers` JSON | **S2**:整目录复制到 `~/.agents/skills/zenmcp`,并将 `widgets/zenmcp-*` 复制到 `~/.superone/widget/`(alpha 为 `~/.superone/alpha/widget/`) |
|
|
80
|
+
| **Claude Code** | **M1**:执行 `claude mcp add -s user zenmcp -- "<node_path>" "<server_entry>"` | **S1**:`~/.claude/skills/zenmcp/SKILL.md` |
|
|
81
|
+
| **Codex** (OpenAI) | **M1 / M2-TOML**:执行 `codex mcp add zenmcp -- "<node_path>" "<server_entry>"`,或备份合并 `~/.codex/config.toml` 的 `[mcp_servers.zenmcp]` | **S1**:`~/.codex/skills/zenmcp/SKILL.md` |
|
|
82
|
+
| **Grok CLI** (xAI) | **M2-TOML**:备份合并 `~/.grok/config.toml` 的 `[mcp_servers.zenmcp]`(`command = "<node_path>"`、`args = ["<server_entry>"]`),可用 `grok inspect` 检查 | **S1**:`~/.grok/skills/zenmcp/SKILL.md` |
|
|
83
|
+
| **DeepSeek Harness (`dsh`)** | **M2-YAML**:在 `~/.dsh/` 当前 profile 的 Cordis 配置中为 `@deepseek-ai/dsh-mcp-client` 添加 stdio 服务 | **S1**:`~/.dsh/skills/zenmcp/SKILL.md` |
|
|
84
|
+
| **Cursor** | **M2-JSON**:备份合并 `~/.cursor/mcp.json`(`mcpServers`) | **S1**:`~/.cursor/skills/zenmcp/SKILL.md` |
|
|
85
|
+
| **Trae / Trae CN** | **M2-JSON**:备份合并 `~/.trae/mcp.json`(`mcpServers`) | **S1**:当前项目工作区 `.trae/skills/zenmcp/SKILL.md`(无工作区则跳过) |
|
|
86
|
+
| **CodeBuddy / WorkBuddy** | **M2-JSON**:CodeBuddy 合并 `~/.codebuddy/mcp.json`;WorkBuddy 合并 `~/.workbuddy/mcp.json`(`mcpServers`) | **S1**:CodeBuddy 为 `~/.codebuddy/skills/zenmcp/SKILL.md`;WorkBuddy 如无 skills 目录则跳过 |
|
|
87
|
+
| **豆包电脑版** | **M3**:输出绝对路径 JSON 块,引导左侧「技能·连接器 → 添加 MCP」粘贴 | **S1**:复制到豆包 Agent 工作区的 `.user_skills/zenmcp/SKILL.md` |
|
|
88
|
+
| **Claude Desktop** | **M2-JSON**:备份合并 macOS `~/Library/Application Support/Claude/claude_desktop_config.json` 或 Windows `%APPDATA%\Claude\claude_desktop_config.json` | **S0**:跳过 |
|
|
89
|
+
| **VS Code (Copilot)** | **M2-异构 JSON**:合并用户级 `mcp.json` 或工作区 `.vscode/mcp.json`,**顶层键为 `"servers"`**,条目为 `{"type":"stdio","command":"<node_path>","args":["<server_entry>"]}` | **S0 / S1**:有项目工作区可写 `.github/skills/zenmcp/SKILL.md`,否则跳过 |
|
|
90
|
+
| **OpenCode** | **M2-异构 JSON**:备份合并 `~/.config/opencode/opencode.json`,在 **`"mcp"`** 下配置 `"zenmcp": {"type":"local","command":["<node_path>","<server_entry>"],"enabled":true}` | **S1**:`~/.config/opencode/skills/zenmcp/SKILL.md` |
|
|
91
|
+
| **Gemini CLI** | **M2-JSON**:备份合并 `~/.gemini/settings.json`(`mcpServers`,保留全部其他字段) | **S1**:`~/.gemini/skills/zenmcp/SKILL.md` |
|
|
92
|
+
| **Antigravity / Windsurf / Kiro** | **M2-JSON**:分别合并 `~/.gemini/antigravity/mcp_config.json`、`~/.codeium/windsurf/mcp_config.json`、`~/.kiro/settings/mcp.json`(`mcpServers`) | **S1**:支持全局 `skills/` 时写入对应 `skills/zenmcp/SKILL.md`,否则跳过 |
|
|
93
|
+
| **OpenClaw** | **M2-JSON5**:先读取 `~/.openclaw/openclaw.json` 确认结构后合并或通过 `mcporter` 注册 | **S1**:`~/.openclaw/skills/zenmcp/SKILL.md` |
|
|
94
|
+
| **Muse / Cherry Studio / Cline / Roo Code** | **M3**:输出绝对路径 JSON 块,引导在当前软件的「Settings → Connectors」或「MCP 服务器」面板粘贴 | **S0**:跳过 |
|
|
77
95
|
|
|
78
|
-
|
|
96
|
+
### 未知宿主自省兜底流程
|
|
79
97
|
|
|
80
|
-
|
|
98
|
+
当当前软件未在上表中出现时,按三步自主探索:
|
|
81
99
|
|
|
82
|
-
|
|
100
|
+
1. 检查自身工具列表是否有内置 MCP 注册工具,或在终端尝试 `<当前宿主CLI> mcp --help` 查看原生命令。
|
|
101
|
+
2. 若具备联网搜索或本地文档检索能力,主动查询 `<当前软件名> MCP configuration file format path skills directory`,核实配置文件路径与顶层键名。
|
|
102
|
+
3. 凡无法 100% 确认外部配置文件路径与格式时,**严禁盲猜写文件**,自动退回 **M3 模式**,输出已填好真实绝对路径的标准配置块,请用户在当前软件的 MCP / 连接器设置界面粘贴。
|
|
83
103
|
|
|
84
|
-
|
|
85
|
-
zenmcp login
|
|
86
|
-
```
|
|
104
|
+
首次写入或粘贴完成后,重载或新开一次宿主会话使工具挂载生效。
|
|
87
105
|
|
|
88
|
-
|
|
106
|
+
## 4. 按运行环境匹配零密文绑 Key 通道(一次保存,同机共用)
|
|
89
107
|
|
|
90
|
-
|
|
91
|
-
zenmcp-setup
|
|
92
|
-
```
|
|
108
|
+
引导用户前往 https://zenaigc.com/console (或 https://api.zenaigc.com )登录并创建平台 Key,按环境分流:
|
|
93
109
|
|
|
94
|
-
|
|
110
|
+
- **A0(已绑定)**:`zenmcp-doctor` 显示 `config.credentials_file: true` 时直接跳过,说明本机安全凭据库已有可用 Key。
|
|
111
|
+
- **A1(本机图形桌面,`headless_or_ssh: false`)**:由 Agent 直接运行以下命令启动本机 `127.0.0.1` 网页连接卡片(保存后临时端口自动关闭,写入 `0600` 权限凭据库,同机所有客户端共用且免重启生效):
|
|
112
|
+
```bash
|
|
113
|
+
"<node_path>" "<setup_bin>"
|
|
114
|
+
```
|
|
115
|
+
若宿主沙盒禁止弹出浏览器,改用 `"<node_path>" "<setup_bin>" --no-open` 输出本地地址或将该完整命令交由用户执行。
|
|
116
|
+
- **A2(纯终端或远程 SSH,`headless_or_ssh: true`)**:请用户在运行 `zenmcp` 的机器终端自行执行以下命令隐藏粘贴保存(若 `zenmcp` 已在系统 `PATH` 可直接运行 `zenmcp login`):
|
|
117
|
+
```bash
|
|
118
|
+
"<node_path>" "<setup_bin>" --terminal
|
|
119
|
+
```
|
|
95
120
|
|
|
96
|
-
如需按单个客户端单独指定 Key,也兼容在客户端配置块中加入 `"env": { "ZENMCP_TOKEN": "<平台Key>" }` 并重载客户端(注意:`env.ZENMCP_TOKEN`
|
|
121
|
+
如需按单个客户端单独指定 Key,也兼容在客户端配置块中加入 `"env": { "ZENMCP_TOKEN": "<平台Key>" }` 并重载客户端(注意:`env.ZENMCP_TOKEN` 优先级高于本机凭据文件;若其中旧 Key 已失效,需先移除或更新并重载)。如需清除本机保存的凭据,可运行 `"<node_path>" "<setup_bin>" logout`(或 `zenmcp logout`)。
|
|
97
122
|
|
|
98
|
-
##
|
|
123
|
+
## 5. 只投递当前宿主的 Skill(S0 / S1 / S2)
|
|
99
124
|
|
|
100
|
-
|
|
125
|
+
使用第 2 步得到的 `skill_dir`:
|
|
101
126
|
|
|
102
|
-
|
|
127
|
+
- **S2(SuperOne)**:将 `<skill_dir>` 整个目录复制到 `~/.agents/skills/zenmcp`(含 `SKILL.md` 与 `widgets/`),并把 `<skill_dir>/widgets/zenmcp-*` 复制到 `~/.superone/widget/`(alpha 版为 `~/.superone/alpha/widget/`)。
|
|
128
|
+
- **S1(支持 `SKILL.md` 的其他宿主)**:先创建当前宿主对应的 `skills/zenmcp` 目录,**仅复制 `<skill_dir>/SKILL.md` 单文件**(不复制 `widgets/`,更不写入其他客户端的目录)。
|
|
129
|
+
- **S0(不支持 Skills 的宿主)**:跳过本步。
|
|
103
130
|
|
|
104
|
-
##
|
|
131
|
+
## 6. 连通验证与收尾
|
|
105
132
|
|
|
106
|
-
|
|
133
|
+
- **当前会话已原生挂载 `zenmcp` 工具时**:直接调用只读工具 `account_status`,原样展示积分信息与「可以这样说」欢迎块(有效可用积分为 0 时引导前往 https://zenaigc.com/console 充值或调整 Key 限额),五步清单全部标 `[x]`。
|
|
134
|
+
- **需界面粘贴(M3)或尚未重载会话(M1/M2)时**:保持「启用与验证」为 `[ ]`,明确提示用户在完成界面粘贴或重载/新开对话后,发送「检查我的 ZenMCP 账户状态」即可完成最后一步验证。
|
package/dist/src/doctor.js
CHANGED
|
@@ -1,14 +1,86 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { realpath } from 'node:fs/promises';
|
|
3
|
-
import {
|
|
3
|
+
import { platform as osPlatform } from 'node:os';
|
|
4
|
+
import { dirname, join } from 'node:path';
|
|
5
|
+
import { fileURLToPath, pathToFileURL } from 'node:url';
|
|
4
6
|
import { checkEffectsRuntime } from './effects/index.js';
|
|
7
|
+
import { CLIENT_VERSION } from './mcp/server.js';
|
|
8
|
+
import { isHeadlessOrSsh } from './setup/cli.js';
|
|
5
9
|
import { hasSavedCredential } from './setup/credentials.js';
|
|
10
|
+
export function isAppSandboxRuntime(nodePath, pkgRoot, cwd) {
|
|
11
|
+
const candidates = [nodePath, pkgRoot, cwd].map(value => value.replaceAll('\\', '/').toLowerCase());
|
|
12
|
+
return candidates.some(value => (value.includes('/doubao/sandbox_runtime/') ||
|
|
13
|
+
value.includes('/sandbox_runtime/bases/') ||
|
|
14
|
+
value.includes('/doubao/default/sandbox_envs_dir/') ||
|
|
15
|
+
(value.includes('/appdata/local/doubao/') && value.includes('sandbox_runtime'))));
|
|
16
|
+
}
|
|
17
|
+
export function detectHostHint(env, cwd, nodePath) {
|
|
18
|
+
if (env.SUPERONE_SESSION_DIR || env.SUPERONE_SESSION_ID || env.SUPERONE_ENV || env.SUPERONE_HOST) {
|
|
19
|
+
return 'superone';
|
|
20
|
+
}
|
|
21
|
+
const normalizedCwd = cwd.replaceAll('\\', '/').toLowerCase();
|
|
22
|
+
const normalizedNode = nodePath.replaceAll('\\', '/').toLowerCase();
|
|
23
|
+
if (normalizedCwd.includes('/.doubao/agent_mode') ||
|
|
24
|
+
normalizedCwd.includes('/application support/doubao/') ||
|
|
25
|
+
normalizedCwd.includes('/appdata/local/doubao/') ||
|
|
26
|
+
normalizedNode.includes('/application support/doubao/') ||
|
|
27
|
+
normalizedNode.includes('/appdata/local/doubao/')) {
|
|
28
|
+
return 'doubao';
|
|
29
|
+
}
|
|
30
|
+
if (env.OPENCLAW_CONFIG_PATH || env.OPENCLAW_HOME || normalizedCwd.includes('/.openclaw/')) {
|
|
31
|
+
return 'openclaw';
|
|
32
|
+
}
|
|
33
|
+
const termProgram = env.TERM_PROGRAM?.toLowerCase() ?? '';
|
|
34
|
+
if (env.CURSOR_TRACE_ID || env.CURSOR_SESSION_ID || termProgram === 'cursor') {
|
|
35
|
+
return 'cursor';
|
|
36
|
+
}
|
|
37
|
+
if (env.TRAE_SESSION_ID || env.TRAE_TRACE_ID || termProgram.includes('trae')) {
|
|
38
|
+
return 'trae';
|
|
39
|
+
}
|
|
40
|
+
if (env.WINDSURF_SESSION_ID || termProgram.includes('windsurf')) {
|
|
41
|
+
return 'windsurf';
|
|
42
|
+
}
|
|
43
|
+
if (env.CODEBUDDY_SESSION_ID || env.WORKBUDDY_SESSION_ID || termProgram.includes('codebuddy')) {
|
|
44
|
+
return 'codebuddy';
|
|
45
|
+
}
|
|
46
|
+
if (env.VSCODE_PID || termProgram === 'vscode') {
|
|
47
|
+
return 'vscode';
|
|
48
|
+
}
|
|
49
|
+
if (env.CLAUDECODE === '1' || env.CLAUDE_CODE_ENTRYPOINT) {
|
|
50
|
+
return 'claude-code';
|
|
51
|
+
}
|
|
52
|
+
if (env.CODEX_SANDBOX || env.CODEX_THREAD_ID || env.CODEX_CI) {
|
|
53
|
+
return 'codex';
|
|
54
|
+
}
|
|
55
|
+
if (env.GROK_CLI || env.GROK_SESSION_ID) {
|
|
56
|
+
return 'grok';
|
|
57
|
+
}
|
|
58
|
+
if (env.DSH_PROFILE || env.DSH_HOME || env.CORDIS_HOME) {
|
|
59
|
+
return 'dsh';
|
|
60
|
+
}
|
|
61
|
+
if (env.ANTIGRAVITY_CLI_ALIAS || env.GEMINI_CLI) {
|
|
62
|
+
return 'gemini';
|
|
63
|
+
}
|
|
64
|
+
if (env.OPENCODE || env.OPENCODE_CONFIG) {
|
|
65
|
+
return 'opencode';
|
|
66
|
+
}
|
|
67
|
+
return 'unknown';
|
|
68
|
+
}
|
|
6
69
|
/** Local readiness only: configuration values and server connectivity stay private. */
|
|
7
|
-
export async function checkEnvironment(env = process.env) {
|
|
70
|
+
export async function checkEnvironment(env = process.env, options = {}) {
|
|
8
71
|
const checks = [
|
|
9
72
|
{ name: 'Node', ok: Number(process.versions.node.split('.')[0]) >= 22 },
|
|
10
73
|
...await checkEffectsRuntime(),
|
|
11
74
|
];
|
|
75
|
+
const selfPath = await realpath(fileURLToPath(import.meta.url)).catch(() => fileURLToPath(import.meta.url));
|
|
76
|
+
const normalizedSelf = selfPath.replaceAll('\\', '/');
|
|
77
|
+
const distSrcDir = normalizedSelf.includes('/dist/src/')
|
|
78
|
+
? dirname(selfPath)
|
|
79
|
+
: join(dirname(dirname(selfPath)), 'dist', 'src');
|
|
80
|
+
const pkgRoot = dirname(dirname(distSrcDir));
|
|
81
|
+
const currentPlatform = options.platform ?? osPlatform();
|
|
82
|
+
const currentCwd = options.cwd ?? process.cwd();
|
|
83
|
+
const nodePath = options.execPath ?? process.execPath;
|
|
12
84
|
return {
|
|
13
85
|
ok: checks.every(check => check.ok),
|
|
14
86
|
checks,
|
|
@@ -17,6 +89,17 @@ export async function checkEnvironment(env = process.env) {
|
|
|
17
89
|
ZENMCP_TOKEN: Boolean(env.ZENMCP_TOKEN),
|
|
18
90
|
credentials_file: await hasSavedCredential({ env }),
|
|
19
91
|
},
|
|
92
|
+
runtime: {
|
|
93
|
+
client_version: CLIENT_VERSION,
|
|
94
|
+
platform: currentPlatform,
|
|
95
|
+
headless_or_ssh: isHeadlessOrSsh(env, currentPlatform),
|
|
96
|
+
in_app_sandbox: isAppSandboxRuntime(nodePath, pkgRoot, currentCwd),
|
|
97
|
+
detected_host_hint: detectHostHint(env, currentCwd, nodePath),
|
|
98
|
+
node_path: nodePath,
|
|
99
|
+
server_entry: join(distSrcDir, 'mcp', 'server.js'),
|
|
100
|
+
setup_bin: join(distSrcDir, 'setup', 'cli.js'),
|
|
101
|
+
skill_dir: join(pkgRoot, 'skills', 'zenmcp'),
|
|
102
|
+
},
|
|
20
103
|
};
|
|
21
104
|
}
|
|
22
105
|
const entry = process.argv[1] ? await realpath(process.argv[1]).catch(() => process.argv[1]) : '';
|
package/dist/src/mcp/server.js
CHANGED
|
@@ -17,7 +17,7 @@ import { trimMedia } from '../acquire/trim.js';
|
|
|
17
17
|
import { ACCOUNT_URL, ERROR_GUIDANCE, POLL_AFTER_SECONDS, LARGE_AMOUNT_CREDITS, LARGE_BALANCE_RATIO, errorGuidance } from './guidance.js';
|
|
18
18
|
import { createDefaultTokenProvider } from '../setup/credentials.js';
|
|
19
19
|
export const DEFAULT_BASE_URL = 'https://api.zenaigc.com/api/v1';
|
|
20
|
-
export const CLIENT_VERSION = '0.1.
|
|
20
|
+
export const CLIENT_VERSION = '0.1.9';
|
|
21
21
|
const inputSchema = z.object({
|
|
22
22
|
job: jobSchema, reference: z.string().min(1),
|
|
23
23
|
output: z.object({ duration_seconds: z.number().int(), resolution: z.enum(['480P', '720P', '1080P']), ratio: z.string(), seed: z.number().int().optional() }),
|