Hydra MCP

本项目实现了一个 Hydra MCP (模型控制协议) 服务器，该服务器使 Claude 能够通过 REST API 接口与各种客户端功能进行交互。该系统由一个中央服务器组成，该服务器协调多个客户端之间的通信，并通过标准化的 API 将其功能暴露给 Claude。

项目结构

• ipc_server.py: 管理功能注册和路由的中央 FastAPI 服务器
• ipc_api.py: 将客户端功能暴露给 Claude 的 Hydra MCP 接口
• fake_client.py: 用于测试的示例客户端实现
• fake_claude.py: Claude 接口的测试实现

功能特性

• 集中式功能注册中心，适用于多个客户端
• 用于功能发现和调用的 REST API 端点
• 客户端和 Claude 之间的标准化通信协议
• 易于使用的功能注册系统
• 自动功能发现和文档生成

API 端点

服务器端点

• POST /register_functions: 注册来自客户端的新功能
• GET /get_functions: 检索所有已注册功能的列表

MCP 工具

• get_endpoints(): 列出所有可用的端点
• get_registered_functions(endpoint): 获取在特定端点可用的功能
• call_function(endpoint, function_name, arguments): 使用参数调用特定功能

使用方法

1. 启动中央服务器：

python ipc_server.py

2. 注册客户端功能：

# 示例客户端注册
functions = [
    {
        "name": "example_function",
        "description": "一个示例函数",
        "parameters": {
            "param1": "string",
            "param2": "integer"
        }
    }
]

requests.post(
    f"http://localhost:{API_SERVER_PORT}/register_functions",
    json={
        "endpoint": "client1",
        "functions": functions
    }
)

3. 使用 MCP 接口与功能进行交互：

# 获取可用的端点
endpoints = get_endpoints()

# 获取特定端点的功能
functions = get_registered_functions("localhost:1234")

# 调用一个函数
result = call_function("localhost:1234", "example_function", {"param1": "value", "param2": 42})

配置

服务器默认在端口 6565 上运行。可以通过更改 ipc_server.py 和 ipc_api.py 中的 API_SERVER_PORT 常量来修改此端口。

依赖项

• FastAPI
• uvicorn
• requests
• fastmcp

测试

该项目包括用于测试功能的示例实现（fake_client.py 和 fake_claude.py）。这些可以作为创建新客户端或测试系统的参考实现。