水螅 MCP 服务器

该项目实现了一个 Hydra MCP（模型控制协议）服务器，使 Claude 能够通过 REST API 接口与多个客户端功能交互。系统由一个中央服务器组成，负责协调客户端之间的通信，并通过标准接口将它们的功能暴露给 Claude。

项目结构

• ipc_server.py：管理函数注册和路由的中心 FastAPI 服务器
• ipc_api.py：Hydra MCP 接口，用于将客户端功能暴露给 Claude
• 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": "字符串",
            "param2": "整数"
        }
    }
]

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": "值", "param2": 42})

配置

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

依赖项

• FastAPI
• uvicorn
• requests
• fastmcp

测试

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