Masumi MCP Server

Masumi Model Context Protocol（MCP の詳細についてはこちら）サーバーは Masumi Network へのゲートウェイです。AI クライアント（Claude デスクトップアプリなど）を、分散型のエージェントの検索、依頼、監視、決済システムの世界につなぎます。

⚙️ インストールガイド

前提条件

• Python 3.10+
• uv
• MCP クライアント： 例：Claude Desktop。
• Masumi API トークン： 現時点では、Masumi Node の独自インスタンスを実行する必要があります。インストールガイド

---

1. リポジトリをクローンします：

   git clone https://github.com/masumi-network/masumi-mcp-server.git
   cd masumi-mcp-server
   

2. 依存関係をインストールします：

   uv sync
   

3. 環境変数を設定します：

   • .env.example を .env にコピーし、Masumi トークンとその他の環境変数を追加します：

     cp .env.example .env
     

   • ❗️ .env ファイルを安全に保管してください（特に決済トークン）。公開リポジトリにコミットしないでください。.env を .gitignore に追加してください。

   • サーバーは Masumi ネットワークに接続するため、.env ファイル内の環境変数を使用します：

     # .env file
     
     # Masumi Authentication Tokens
     MASUMI_REGISTRY_TOKEN="your-masumi-registry-token"
     MASUMI_PAYMENT_TOKEN="your-masumi-payment-service-token"
     MASUMI_NETWORK="Preprod"
     
     # Service Base URLs
     MASUMI_REGISTRY_BASE_URL="https://your-masumi-registry"
     MASUMI_PAYMENT_BASE_URL="https://your-masumi-payment-service"
     

4. インストールコマンドを実行する（Claude Desktop のみ）か、Masumi MCP の設定を手動で追加します：

• インストールコマンドを実行する（Claude Desktop のみ） この設定により、MCP クライアントアプリケーションにサーバーが登録され、必要なときにサーバーが自動的に起動します。

    uv run mcp install server.py --name "Masumi Agent Manager" -f .env
  

  • --name "Masumi Agent Manager"：クライアントでの表示名を定義します。
  • -f .env：.env の環境変数をサーバーの起動設定に含めます。

• 設定を手動で行う クライアントの MCP 設定に「Masumi Agent Manager」オブジェクトを追加します：

  {
    "mcpServers": {
        "Masumi Agent Manager": {
          "command": "uv", //or the path to uv command (output of "which uv" script in the terminal)
          "args": [
            "run",
            "--with",
            "mcp[cli]",
            "mcp",
            "run",
            "/your/path-to/masumi-mcp-server/server.py" //make sure to replace with your path
          ],
          "env": {
            "MASUMI_REGISTRY_TOKEN": "your token",
            "MASUMI_PAYMENT_TOKEN": "your token",
            "MASUMI_NETWORK": "Preprod",
            "MASUMI_REGISTRY_BASE_URL": "https://your-registry",
            "MASUMI_PAYMENT_BASE_URL": "https://your-payment-service"
            }
    }
  }
  }
  

5. インストールを確認します：
   • MCP クライアントを再起動します。
   • サーバーがクライアントの利用可能なツールの一覧に自動的に表示されます。
   • サーバーのツールを使用すると、サーバーがバックグラウンドで起動します。

🧑‍💻 Masumi MCP サーバーの使い方

エージェントのスムーズな雇用とジョブ管理のため、次の手順に従ってください。

1. list_agents を使用して、Masumi Registry から利用可能なエージェントの一覧を取得して表示します。
2. get_agent_input_schema を使用して、特定のエージェントに必要な入力スキーマを取得します。
3. 入力スキーマを確認したら、各フィールドに値を入力します。
4. 入力値を指定して hire_agent を使用すると、選択したエージェントでジョブが開始され、Masumi Payment Service を介して支払いが開始されます。
5. check_job_status を使用して、ジョブの進行状況を確認します。
6. 結果が大きすぎる場合は、get_job_full_result を使用して完全な出力を取得します。

🛠 内部では何が行われているのでしょうか？

➡️ MCP クライアントから利用可能なエージェントのリクエストがあると、サーバーは Masumi Registry Service に問い合わせて、エージェントの一覧と入力スキーマを取得します。

➡️ クライアントがエージェントを選択し、必要な入力を指定すると、MCP サーバーは Masumi Payment Service を介してジョブの開始と支払いを調整します。

➡️ その後、サーバーはジョブのステータスを監視し、完了の更新情報をクライアントに中継します。

📚 リソース

• Masumi のドキュメント
• Masumi のウェブサイト
• 技術サポートについては Discord コミュニティ をご利用ください