Hydra MCP

🚀 水螅 MCP サーバー

このプロジェクトは、Hydra MCP（モデル制御プロトコル）サーバーを実装しており、Claude が REST API インターフェースを介して複数のクライアント機能と相互作用できるようにします。システムは中央サーバーで構成され、クライアント間の通信を調整し、標準インターフェースを通じてそれらの機能を Claude に公開します。

🚀 クイックスタート

このサーバーを使用することで、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

💻 使用例

基本的な使用法

# 示例客户端注册
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})

📚 ドキュメント

プロジェクト構造

• 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）が含まれており、機能の検証に使用できます。これらのサンプルは、新しいクライアントの作成やシステムのテストの参考にできます。