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），可用於驗證功能。這些示例可作為參考，用於創建新的客戶端或測試系統。