Hydra MCP 服务端使用说明

• 项目简介

  • Hydra 是一个面向多智能体并行工作的编排工具。此 MCP 服务器将 Hydra 封装为 MCP 服务，提供统一的访问入口，允许 LLM 客户端通过 MCP 协议获取资源、注册和执行工具、以及处理提示模板等能力，从而在后端以标准化方式提供上下文服务。

• 主要功能点

  • MCP 服务端实现核心能力
    • 提供信息查询、项目设置与初始化等接口，以及在客户端发起命令时执行 Hydra CLI 命令的能力。
  • 资源与工具的执行入口
    • 将 Hydra 的资源、任务与工作流通过工具接口暴露，方便 LLM 客户端调用。
  • 多传输协议支持
    • 设计为支持 StdIO、SSE、WebSocket 等传输方案，使 MCP 客户端与服务端的通信更加灵活。
  • 与 Hydra 的深度集成
    • 通过 hydra.py 作为后端实现，MCP 服务端通过加载 Hydra 脚本实现对 Hydra 功能的远程调用。
  • 客户端友好的集成示例
    • README 中给出 OpenClaw、Claude Code 等集成示例，方便将 Hydra 作为 MCP 服务接入现有工作流。

• 安装步骤

  • 准备 Hydra 代码
    • Clone or获取 Hydra 的主代码（包含 hydra.py 与相关脚本）。
  • 安装 MCP 服务端
    • 进入 hydra_mcp 目录，执行安装：pip install -e .
  • 集成到客户端
    • 以 Claude Code 为例，在 MCP 客户端配置中添加 Hydra 服务：
      • 命令示例（客户端无需改动 Hydra 侧代码）：python -m hydra_mcp.server
      • Claude Code 的配置片段示例（客户端为集成配置，不需要 Hydra 端修改）：
        • 服务器名称：Hydra
        • 连接方式：标准输出/输入（stdio）传输
  • 运行与测试
    • 使用 Hydra 提供的工具函数测试 MCP 服务是否就绪，例如通过 Hydra 提供的 hydraInfo、hydraSetProject、hydraInit、hydraRun 等工具方法进行交互。

• 服务器配置（MCP 客户端需要的连接信息）

  • 配置示例（JSON，客户端需要用来连接服务器；服务器名称与启动命令来自仓库信息）:
    • server name: Hydra
    • command: python
    • args: ["-m", "hydra_mcp.server"]
  • 说明
    • 该配置用于 MCP 客户端在启动时连接 Hydra MCP 服务，执行初始化、设置项目、以及执行 Hydra 相关命令等操作。配置内容不属于客户端的编写代码，仅用于说明如何通过 MCP 客户端连接该服务器。

• 基本使用方法

  • 启动与连接
    • 使用含有 Hydra MCP 服务端的配置，在客户端通过指定的启动命令连接 Hyd ra 服务。
  • 常用工作流程
    • hydraInfo：获取 Hydra 服务的基本信息与状态。
    • hydraSetProject：设置并校验当前项目根目录。
    • hydraInit：在给定项目中初始化 Hydra 环境，必要时安装 hydra.py。
    • hydraRun：在指定项目中执行任意 Hydra CLI 命令（如 task、agent、merge 等）。
  • 日常运维
    • 通过客户端工具执行相应的 MCP 调用，Hydra 将在后端执行 Hydra 的脚本逻辑并返回结果。

• 备注

  • 本 MCP 服务端实现通过 hydra.py 的直接依赖来提供实际的业务能力，因此服务端的稳定性与 Hydra 的功能实现紧密耦合。