MetaPM MCP服务器（HO-U9V0）
MCP（模型上下文协议）服务器，允许Claude Desktop直接与MetaPM交互进行切换管理。
什么是MCP？
MCP是Anthropic的AI到工具通信标准。它允许Claude Desktop在对话过程中将外部服务称为“工具”。此服务器将MetaPM的切换和导体API作为MCP工具公开。
快速开始
cd "G:\My Drive\Code\Python\metapm-mcp"
.\setup.ps1这将：
- 安装npm依赖项
- 构建TypeScript
- 配置Claude Desktop（备份现有配置）
- 运行API测试
然后重新启动Claude Desktop。
手动设置
npm install
npm run build复制 claude_desktop_config.example.json 到 %APPDATA%\Claude\claude_desktop_config.json.
可用工具
| 工具 | 说明 | 参数 |
|---|---|---|
handoff_list | 列出最近的交接 | status?, project?, limit? |
handoff_get | 获取完整的切换详细信息 | id （必填） |
handoff_create | 创建新的切换 | project, title, description?, request_type? |
handoff_dispatch | 调度切换到CC | id, prompt, project |
conductor_status | 获取列车长仪表板 | （无） |
用法示例
设置后，询问Claude Desktop：
- “列出MetaPM的最新移交”
- “获取切换HO-A1B2的详细信息”
- “为超级闪卡创建新的切换：修复卡分类”
- “当前导线状态如何？”
- “将HO-A1B2发送到CC，并提示：部署v2.0.8”
配置
服务器从环境变量中读取：
| 变量 | 默认值 | 描述 |
|---|---|---|
METAPM_URL | https://metapm.rentyourcio.com | MetaPM API基础URL |
METAPM_API_KEY | （空） | 已通过身份验证的终结点的API密钥 |
测试
npm run build
npm test故障排除
Claude Desktop未显示MetaPM工具
- 检查配置是否存在：
cat $env:APPDATA\Claude\claude_desktop_config.json - 检查路径
dist/index.js是正确的 - 完全重新启动Claude Desktop（从系统托盘退出）
“MetaPM 401”错误
设置API键： $env:METAPM_API_KEY = "your-key" 然后重新运行安装程序。
工具工作但返回空数据
MetaPM可能需要种子切换数据。检查： curl https://metapm.rentyourcio.com/health
文件
| 文件 | 目的 |
|---|---|
src/index.ts | 带5个工具的MCP服务器 |
src/test_mcp.ts | API集成测试 |
claude_desktop_config.example.json | 配置模板 |
setup.ps1 | 一键设置脚本 |