Claude Octopus MCP Server

关键词

多AI协作工作流编排模型上下文协议OpenClaw 集成设计工作流

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个 MCP 服务器，用来把 Claude Octopus 的 Double Diamond 工作流、辩论与审查等能力以 MCP 工具的形式暴露给 MCP 客户端（如 OpenClaw、Claude.ai、Cursor 等），通过调度现有的 orchestrate.sh 基础设施完成实际执行。
    • MCP 服务器通过 STDIO 传输（StdioServerTransport）与客户端通信，支持按 MCP 标准接收请求、返回响应，并在服务端承担会话管理与能力声明。

  • 主要功能点

    • 暴露的 MCP 工具：octopus_discover、octopus_define、octopus_develop、octopus_deliver、octopus_embrace、octopus_debate、octopus_review、octopus_security，以及用于自省的 octopus_list_skills、octopus_status。
    • 请求转发与执行：所有 MCP 工具请求都会被映射到相应的 orchestrate.sh 子命令（如 probe、grasp、tangle、ink、embrace、grapple、codex-review、squeeze），实现对多模型提供商的统一调度与执行。
    • IDE 集成：提供 octopus_set_editor_context 等工具以注入 IDE 状态（文件、选区、光标等）到工作流中，提升上下文感知能力。
    • 安全与隔离：通过严格的环境变量控制和 sandbox 实践，确保 MCP 客户端无法越权修改关键配置。
    • 与 OpenClaw 兼容：提供 OpenClaw 适配层，可将 Claude Octopus 的工作流通过 OpenClaw 运行和展示，并提供兼容的工具注册与执行路径。
    • 具备自描述能力：提供 octopus_list_skills、octopus_status 等自省工具，便于客户端查询可用技能和当前状态。

  • 安装步骤（简要）

    • 安装依赖并编译为可运行的 dist 目录（若使用 TypeScript，需执行编译得到 dist/index.js）。
    • 启动 MCP 服务器进程：在服务器环境中执行 node mcp-server/dist/index.js（前提是已安装依赖并完成编译）。
    • MCP 客户端通过标准输入输出（STDIO）与该服务建立连接并发起 JSON-RPC 请求。

  • 服务器配置（MCP 客户端需要的配置示例，JSON 形式，按需调整实际环境） { "server_name": "octo-claw", "transport": "stdio", "command": "node", "args": ["mcp-server/dist/index.js"], "version": "1.0.0", "notes": "该配置用于 MCP 客户端通过标准输入输出连接 Claude Octopus 的 MCP 服务。server_name 对应服务器名称，command 与 args 指定启动服务器的命令及参数，transport 指定通信介质。若服务器在不同目录或使用容器运行，请相应调整路径。" }

  • 基本使用方法

    • 启动后，MCP 客户端发起 JSON-RPC 请求，调用示例（由客户端实现方负责格式化和发送）：
      • 调用 octopus_discover 获取某个主题的多模型研究结果
      • 调用 octopus_embrace 完整工作流或逐阶段执行
      • 调用 octopus_debate/octopus_review/octopus_security 进行相应的专业评审与安全检查
    • 客户端通过服务器返回的 JSON-RPC 响应进行处理与渲染，必要时通过 octopus_status 观察当前提供者状态。
    • 如需 IDE 上下文协助，请先调用 octopus_set_editor_context 设置编辑器上下文，再执行相关工作流。

  • 兼容与扩展

    • 本 MCP 服务器实现了对多模型提供商的协作与质量门控（如 75% 一致性门槛），并支持后续扩展到更多工作流阶段与更丰富的工具集合。
    • 与 OpenClaw 的兼容扩展让 MCP 客户端能够将工作流直接暴露给对话式身份的机器人平台。

  • 注意事项

    • 服务器绑定策略、跨进程通信、以及环境变量的严格控制均在实现层面进行了处理，确保安全性与稳定性。
    • 如果要在 OpenClaw 或其他 MC 客户端中使用，请按 OpenClaw 的扩展部署流程进行注册与工具绑定。

  • 运行与调试建议

    • 在本地开发环境中，先编译 TypeScript 代码，确保 dist/index.js 成功生成，然后使用 node 运行 dist/index.js。
    • 如遇端口、输入输出流等通信问题，请检查客户端的连接方式是否符合 MCP 的 STDIO 传输约定。

服务器信息

访问项目