Minion Toolkit MCP 服务器

使用说明(Markdown 格式)

  1. 项目简介
  • 该仓库内的 mcp-server 提供一个基于 MCP 的服务器实现,核心功能是通过 JSON-RPC 向客户端提供资源数据访问、工具调用能力、以及可渲染的 Prompt 模板。服务器端负责会话管理、能力声明,以及对多种传输协议的支持,面向 LLM 应用提供上下文服务。
  1. 主要功能点
  • MCP 核心能力
    • 主机资源与数据访问(Resources)
    • 注册与执行 Tools(Tools),LLM 客户端可调用外部功能
    • 提供并渲染 Prompt 模板(Prompts),支持自定义交互模式
    • 会话管理与能力声明
    • 支持多传输协议(如 Stdio),用于与 Claude Code 客户端交互
  • 服务器端实现要点
    • 基于 JSON-RPC 的请求/响应处理
    • 内置工具集合:启动 Minion、查询状态、获取结果、创建 Pr、清理会话等
    • DAG/资源/成本等辅助工具,支撑更可靠的任务编排
    • 与 Git、工作树、任务解析、DAG 解析、成本估算、范围检查、集成报告等模块整合
  1. 安装步骤
  • 进入 mcp-server 目录,安装依赖并编译
    • 安装依赖
    • 构建服务器
  • 参考仓库自带的测试与示例,确保环境可运行
  1. 服务器配置(MCP 客户端配置) MCP 客户端需要向 MCP 服务器注册连接信息。以下为服务器端配置示例描述(JSON 形式,供 MCP 客户端了解如何连接服务器;实际配置请在客户端使用)。字段含义如下:
  • name: 服务器名称,与 MCP 配置中的标识一致
  • command: 启动服务器的命令
  • args: 启动命令的参数数组
  • env: 环境变量,例如 API 密钥等 示例描述性配置(文本格式,便于理解): { "name": "minion-toolkit", "command": "node", "args": ["/path/to/minion-toolkit/mcp-server/dist/index.js"], "env": { "ANTHROPIC_API_KEY": "your-key-here" } // 说明:这是 MCP 客户端需要的连接信息,实际路径和密钥请按你的部署环境替换。 } 说明注释:
  • 服务器名称应与实际部署一致,用于在 MCP 客户端进行标识和路由。
  • command/args 指定启动 MCP 服务器的命令及入口文件路径,dist/index.js 为编译后的入口。
  • env 中的 ANTHROPIC_API_KEY 是调用模型所需的认证密钥,请在部署环境中保护好该密钥。
  1. 基本使用方法
  • 启动服务器:在合适的环境中执行服务器入口(如 dist/index.js)以开启 MCP 服务
  • 客户端调用:通过 MCP 客户端与服务器进行 JSON-RPC 交互,请求包括启动任务、查询状态、获取结果等,服务器返回标准的 JSON-RPC 响应
  • 集成工作流:结合任务解析、DAG 解析、成本估算、范围检查、集成报告等工具,完成任务编排与评估
  1. 运行与测试
  • 参考仓库中的单元测试与示例用法,确保本地环境能够构建并运行 MCP 服务
  • 如需与 Claude Code 进行集成,请在 Claude Code 配置中注册上述 MCP 服务器,并确保传输通道与鉴权配置正确

服务器信息