Hydra MCP

Hydra MCP

本项目实现了一个 Hydra MCP（Model Control Protocol）服务，使 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. 注册客户端功能：

# Example client registration
functions = [
    {
        "name": "example_function",
        "description": "An example function",
        "parameters": {
            "param1": "string",
            "param2": "integer"
        }
    }
]

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

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

# Get available endpoints
endpoints = get_endpoints()

# Get functions for a specific endpoint
functions = get_registered_functions("localhost:1234")

# Call a function
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）。可将其用作创建新客户端或测试系统的参考实现。