Hydra MCP

🚀 水螅 MCP 服务器

该项目实现了一个水螅 MCP（模型控制协议）服务器，借助此服务器，Claude 能够通过 REST API 接口与多个客户端进行功能交互。系统由一个中央服务器构成，其主要职责是协调客户端之间的通信，并通过标准接口将客户端的功能提供给 Claude 使用。

🚀 快速开始

启动中央服务器

python ipc_server.py

注册客户端功能

# 示例客户端注册
functions = [
    {
        "name": "example_function",
        "description": "一个示例功能",
        "parameters": {
            "param1": "字符串",
            "param2": "整数"
        }
    }
]

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

使用 MCP 接口与功能交互

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

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

# 调用功能
result = call_function("localhost:1234", "example_function", {"param1": "值", "param2": 42})

✨ 主要特性

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

📦 安装指南

本项目的依赖项如下：

• FastAPI
• uvicorn
• requests
• fastmcp

你可以使用以下命令安装这些依赖项（假设使用 pip 包管理器）：

pip install fastapi uvicorn requests fastmcp

💻 使用示例

基础用法

# 启动中央服务器
python ipc_server.py

# 示例客户端注册
functions = [
    {
        "name": "example_function",
        "description": "一个示例功能",
        "parameters": {
            "param1": "字符串",
            "param2": "整数"
        }
    }
]

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

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

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

# 调用功能
result = call_function("localhost:1234", "example_function", {"param1": "值", "param2": 42})

高级用法

# 可以根据实际需求，创建多个客户端并注册不同的功能
# 例如创建 client2 并注册不同的功能
functions_client2 = [
    {
        "name": "another_function",
        "description": "另一个示例功能",
        "parameters": {
            "param3": "布尔值"
        }
    }
]

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

# 调用 client2 的功能
result_client2 = call_function("localhost:1234", "another_function", {"param3": true})

📚 详细文档

项目结构

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

API 端点

服务端端点

• POST /register_functions：客户端注册新功能
• GET /get_functions：获取所有已注册的功能列表

MCP 工具

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

配置

服务器默认运行在 6565 端口。如有需要，可以在 ipc_server.py 和 ipc_api.py 中修改 API_SERVER_PORT 常量。

测试

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