Protocols Io MCP Server

🚀 Protocols.io MCP Server

Model Context Protocol (MCP)サーバーで、Claude DesktopなどのMCPクライアントが科学的なプロトコルや方法を共有するための人気プラットフォームであるprotocols.ioとやり取りできるようにします。

🚀 クイックスタート

このProtocols.io MCP Serverを使用することで、MCPクライアントがprotocols.ioとやり取りできるようになります。

✨ 主な機能

サーバーは、MCPクライアントが使用できる以下のツールを提供します。

検索と取得

• search_public_protocols - キーワードで公開プロトコルを検索します。
• get_protocol - IDで基本的なプロトコル情報を取得します。
• get_protocol_steps - 特定のプロトコルの詳細な手順を取得します。
• get_my_protocols - あなたのアカウントからすべてのプロトコルを取得します。

プロトコルの作成と管理

• create_protocol - タイトルと説明を指定して新しいプロトコルを作成します。
• update_protocol_title - 既存のプロトコルのタイトルを更新します。
• update_protocol_description - 既存のプロトコルの説明を更新します。

手順の管理

• set_protocol_steps - プロトコル内のすべての手順を置き換えます。
• add_protocol_step - プロトコルの末尾に単一の手順を追加します。
• delete_protocol_step - プロトコルから特定の手順を削除します。

📦 インストール

Dockerを使用したクイックスタート

docker run -d -p 8000:8000 -e PROTOCOLS_IO_CLIENT_ACCESS_TOKEN="your_access_token_here" --name protocols-io-mcp --restart always ghcr.io/hqn21/protocols-io-mcp:latest

pipを使用してパッケージをインストールする

pip install protocols-io-mcp

📚 ドキュメント

環境変数

サーバーまたはテストを実行する前に、protocols.io APIアクセストークンを設定する必要があります。

export PROTOCOLS_IO_CLIENT_ACCESS_TOKEN="your_client_access_token"

APIトークンを取得するには：

1. protocols.io/developerにアクセスします。
2. あなたのアカウントにサインインします。
3. APIクライアントのセクションに移動し、新しいクライアントを追加します。
4. 生成されたクライアントアクセストークンをコピーし、環境に設定します。

💻 使用例

コマンドラインインターフェイス

様々なトランスポートオプションでMCPサーバーを実行します。

# デフォルト: stdioトランスポート (MCPクライアントに推奨)
protocols-io-mcp

# HTTPトランスポート
protocols-io-mcp --transport http --host 127.0.0.1 --port 8000

# Server-Sent Eventsトランスポート
protocols-io-mcp --transport sse --host 127.0.0.1 --port 8000

CLIオプション

Usage: protocols-io-mcp [OPTIONS]

  Run the protocols.io MCP server.
    
Options:
  --transport [stdio|http|sse]  Transport protocol to use [default: stdio]
  --host TEXT                   Host to bind to when using http and sse
                                transport [default: 127.0.0.1]
  --port INTEGER                Port to bind to when using http and sse
                                transport [default: 8000]
  --help                        Show this message and exit.

Claude Desktopとの統合

このサーバーをClaude Desktopとともに使用するには、claude_desktop_config.jsonに以下の設定を追加します。

{
  "mcpServers": {
    "protocols-io": {
      "command": "protocols-io-mcp",
      "env": {
        "PROTOCOLS_IO_CLIENT_ACCESS_TOKEN": "your_client_access_token"
      }
    }
  }
}

トラブルシューティング

MCP protocols-io: spawn protocols-io-mcp ENOENT

このエラーは、Claude Desktopがprotocols-io-mcpコマンドを見つけることができないことを示しています。これを解決するには：

1. protocols-io-mcpパッケージをpipを使用してグローバルにインストールしていることを確認します。
2. claude_desktop_config.jsonのcommandフィールドをprotocols-io-mcp実行ファイルの完全パスに変更します。パスは以下のコマンドを実行することで取得できます。

   which protocols-io-mcp
   

3. 最終的な設定は以下のようになります。

   {
     "mcpServers": {
       "protocols-io": {
         "command": "/full/path/to/protocols-io-mcp",
         "env": {
           "PROTOCOLS_IO_CLIENT_ACCESS_TOKEN": "your_client_access_token"
         }
       }
     }
   }
   

🔧 技術詳細

テストの実行

PROTOCOLS_IO_CLIENT_ACCESS_TOKEN環境変数を設定したことを確認してから、以下のコマンドを実行します。

pytest

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。