mcp-dev-cli

面向 Claude Code 的统一并行 MCP 开发助手。

它的正确产品模型是：

• npm install -g mcp-dev-cli 只安装 CLI 命令
• mcp-dev-cli install 只把 当前项目 接入 Claude Code
• 没有执行 install 的项目，不应该出现这个工具

快速开始

1. 安装 CLI

npm install -g mcp-dev-cli@latest

这一步只会把 mcp-dev-cli 命令安装到你的电脑上，不会自动把 MCP 工具接入所有项目。

2. 在目标项目里接入

进入你的项目目录后执行：

mcp-dev-cli install

或者显式指定项目路径：

mcp-dev-cli install "/absolute/project/path"

这一步才会把 mcp-dev-cli 作为 当前项目专用 的 MCP 工具接入 Claude Code。

3. 在 Claude Code 中使用

安装完成后：

1. 用 Claude Code 打开这个项目
2. 输入 /mcp
3. 信任或启用 mcp-dev-cli
4. 运行 parallel_startup
5. 再运行 parallel_requirement 或 parallel_start

如果 Claude Code 在安装前就已经打开了这个项目，请重新打开该项目，让新的 .mcp.json 生效。

标准使用流

项目接入

mcp-dev-cli install

项目移除

mcp-dev-cli uninstall

Claude Code 内使用

/mcp

然后选择或信任：

mcp-dev-cli

接着使用：

• parallel_startup
• parallel_requirement
• parallel_start
• parallel_approve
• parallel_next_batch
• parallel_dashboard
• parallel_report

安装结果预期

执行：

mcp-dev-cli install

成功后应该满足：

• 只在当前项目写入/更新 .mcp.json
• 只在当前项目注册 mcp-dev-cli
• 当前项目可在 Claude Code 的 /mcp 中看到该工具
• 其他未安装的项目不应出现该工具

故障排查

为什么我已经全局安装了 CLI，但别的项目里没有工具？

这是正确行为。

全局安装只提供命令行：

mcp-dev-cli

真正让工具出现在某个项目里的动作，是在该项目执行：

mcp-dev-cli install

/mcp 里没看到 mcp-dev-cli

确认你是在执行过 mcp-dev-cli install 的同一个项目目录里打开 Claude Code。

然后重新执行：

mcp-dev-cli install

如果 Claude Code 已经开着，重新打开当前项目。

卸载后为什么还看到工具？

先执行：

mcp-dev-cli uninstall

如果 Claude Code 已经开着，重新打开当前项目。

Claude CLI 不存在

安装命令会失败并提示先安装 Claude Code CLI。

手动方式（仅用于诊断）

项目级手工接入：

claude mcp add mcp-dev-cli --scope project -- npx -y mcp-dev-cli

项目级手工移除：

claude mcp remove "mcp-dev-cli" -s project