Hydra MCP 服务器

关键词

资源管理工具注册PromptsJSON-RPC事件源守护进程

使用说明

项目简介

Hydra 提供一个多代理编排平台，核心包括一个本地守护进程（daemon），通过 HTTP/JSON-RPC 向客户端暴露资源、工具和提示（Prompts）的管理与执行能力，并支持事件溯源式状态管理与多种传输模式，便于在本地或受控环境中为大型语言模型（LLM）客户端提供上下文服务。

主要功能点

  • MCP 风格的资源、工具与提示管理：集中管理可被 LLM 调用的数据资源、外部工具以及可渲染的提示模板，便于统一访问和执行。
  • JSON-RPC 通信：守护进程以 JSON-RPC 的方式与客户端交互，请求包括读取资源、调用工具、获取和渲染 Prompts 等。
  • 会话与能力声明：提供会话上下文、能力声明和路由能力，支持多种对话模式。
  • 本地化守护进程：事件溯源、回放、快照与死信队列等特性，确保任务的可追溯性和容错性。
  • 多传输与集成：支持本地使用、标准化 HTTP 服务，以及与客户端的无缝集成（如使用本地 STDIO、SSE、WebSocket 等传输方式的扩展）。

安装步骤

  1. 克隆并进入项目：git clone <Hydra 仓库地址>，cd Hydra
  2. 安装依赖：npm install
  3. 启动守护进程（MCP 服务器）：npm start
    • 说明：npm start 将启动 daemon（守护进程）并监听本地 4173 端口，以供 MCP 客户端通过 JSON-RPC 进行通信
  4. 注册与接入客户端：参照官方文档中的 hydra setup/-相关命令，将服务器注册到你使用的 AI CLI

服务器配置（MCP 客户端所需，不需要客户端额外信息）

以下信息用于 MCP 客户端在连接服务器时的基础配置（服务器端配置在客户端并不需要部署），JSON 格式示例，字段含义请参考注释： { "serverName": "Hydra MCP Daemon", "command": "npm", "args": ["start"], "host": "127.0.0.1", "port": 4173 } 注释：

  • serverName：服务器对外显示的名称，便于管理与日志识别。
  • command 与 args：用于在本地启动守护进程的命令及参数。对于 Hydra，守护进程通过 npm start 启动。
  • host 与 port：守护进程监听的地址与端口，客户端通过该地址进行 JSON-RPC 调用（本地使用时通常为 127.0.0.1:4173）。 说明：MCP 客户端不需要该配置本身来执行任务，而是通过读取该信息来进行本地连接配置与初始化。

基本使用方法

  • 启动守护进程：执行 npm start，确保本地防火墙放行端口 4173，并在日志中看到服务器就绪提示。
  • 连接与调用：使用符合 MCP 约定的 JSON-RPC 请求向 http://127.0.0.1:4173 发送请求，读取资源、调用工具、获取并渲染 Prompts 等。
  • 管理与监控：可在操作台（operator console）查看状态、切换模式、注册新的代理与工具、查看任务队列与执行结果。

服务器信息

访问项目