MCP Server

🚀 Blockscout MCP Server

モデルコンテキストプロトコル（MCP）は、AIエージェント、IDE、自動化ツールがコンテキストを考慮したAPIを通じて構造化データを消費、クエリ、分析できるように設計されたオープンプロトコルです。

このサーバーはBlockscout APIをラップし、残高、トークン、NFT、コントラクトメタデータなどのブロックチェーンデータをMCPを介して公開します。これにより、AIエージェントやツール（Claude、Cursor、IDEなど）がコンテキストを考慮してデータにアクセスし、分析することができます。

🚀 クイックスタート

モデルコンテキストプロトコル（MCP）を利用して、AIエージェントやツールがブロックチェーンデータにアクセスできるようにするためのサーバーです。以下のセクションで詳細な使い方を説明します。

✨ 主な機能

• AIツール向けのコンテキストを考慮したブロックチェーンデータアクセス
• ChainscoutからBlockscoutインスタンスのURLを取得することで、マルチチェーンをサポート
• MCPホストがサーバーを使用するためのカスタム命令を提供
• 多段階のツール操作に対するMCP進捗通知をサポートし、クライアントが実行ステータスを追跡できるようにする
• ユーザー体験の向上：クライアントから要求があった場合、長時間実行されるAPIクエリ（大量のトランザクション履歴の取得など）に対して定期的な進捗更新を提供し、応答性を向上させる

🔧 技術詳細

技術的な詳細については、SPEC.mdを参照してください。

📚 ドキュメント

リポジトリ構造

リポジトリの構造については、AGENTS.mdを参照してください。

テスト

単体テストと統合テストの両方を実行するための包括的な手順については、TESTING.mdを参照してください。

ツールの説明

1. __get_instructions__() - MCPホストがサーバーを使用するためのカスタム命令を提供します。このツールは、MCPサーバー初期化応答のinstructionsフィールドがMCPホストで使用されていないため（Claude Desktopでテスト済み）、必須です。
2. get_chains_list() - すべての既知のチェーンのリストを返します。
3. get_address_by_ens_name(name) - ENSドメイン名を対応するイーサリアムアドレスに変換します。
4. lookup_token_by_symbol(chain_id, symbol) - シンボルまたは名前でトークンアドレスを検索し、複数の潜在的な一致を返します。
5. get_contract_abi(chain_id, address) - スマートコントラクトのABI（アプリケーションバイナリインターフェース）を取得します。
6. get_address_info(chain_id, address) - アドレスに関する包括的な情報を取得します。残高、ENS関連付け、コントラクトステータス、トークン詳細などが含まれます。
7. get_tokens_by_address(chain_id, address, cursor=None) - アドレスの詳細なERC20トークン保有量を、豊富なメタデータと市場データとともに返します。
8. get_latest_block(chain_id) - 最新のインデックスされたブロック番号とタイムスタンプを返します。
9. get_transactions_by_address(chain_id, address, age_from, age_to, methods) - 特定の時間範囲内のアドレスのトランザクションを取得し、オプションでメソッドをフィルタリングできます。
10. get_token_transfers_by_address(chain_id, address, age_from, age_to, token) - 特定の時間範囲内のアドレスのERC-20トークン転送を返します。
11. transaction_summary(chain_id, hash) - Blockscoutトランザクションインタープリタを使用して、人間が読めるトランザクションの要約を提供します。
12. nft_tokens_by_address(chain_id, address) - アドレスが所有するNFTトークンをコレクションごとにグループ化して取得します。
13. get_block_info(chain_id, number_or_hash) - ブロック情報を取得します。タイムスタンプ、使用されたガス、燃焼された手数料、トランザクション数などが含まれます。
14. get_transaction_info(chain_id, hash) - 包括的なトランザクション情報を取得し、入力パラメータをデコードし、詳細なトークン転送を表示します。
15. get_transaction_logs(chain_id, hash) - トランザクションログを取得し、イベントデータをデコードします。
16. get_address_logs(chain_id, address, cursor=None) - 特定のアドレスが発行したログを取得し、イベントデータをデコードします。

AIエージェントの使用例（追加予定）

このセクションでは、チャットやIDEからMCPサーバーを介してブロックチェーンデータを取得し、分析するための実用的なプロンプトの例を追加予定です。

📦 インストール

ローカルインストール

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/blockscout/mcp-server.git
cd mcp-server
uv pip install -e . # または `pip install -e .`

サーバーの実行

サーバーはデフォルトでstdioモードで実行されます。

python -m blockscout_mcp_server

HTTP Streamableモード: サーバーをHTTP Streamableモード（ステートレス、JSON応答）で実行するには、次のコマンドを使用します。

python -m blockscout_mcp_server --http

HTTPサーバーのホストとポートを指定することもできます。

python -m blockscout_mcp_server --http --http-host 0.0.0.0 --http-port 8080

CLIオプション:

• --http: HTTP Streamableモードを有効にします。
• --http-host TEXT: HTTPサーバーをバインドするホスト（デフォルト: 127.0.0.1）。
• --http-port INTEGER: HTTPサーバーのポート（デフォルト: 8000）。

ローカルでのDockerイメージのビルド

公式タグでDockerイメージをビルドします。

docker build -t ghcr.io/blockscout/mcp-server:latest .

GitHub Container Registryからのイメージの取得

事前にビルドされたイメージを取得します。

docker pull ghcr.io/blockscout/mcp-server:latest

Dockerでの実行

HTTP Streamableモード: ポートマッピングを行って、DockerコンテナをHTTPモードで実行します。

docker run --rm -p 8000:8000 ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0

カスタムポートを使用する場合:

docker run --rm -p 8080:8080 ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0 --http-port 8080

⚠️ 重要提示

DockerでHTTPモードで実行する場合、--http-host 0.0.0.0を使用してすべてのインターフェースにバインドする必要があります。これにより、コンテナの外部からサーバーにアクセスできるようになります。

💡 使用建议

デフォルトのstdioモードは、MCPホスト/クライアント（Claude Desktop、Cursorなど）での使用を想定しています。MCPクライアントが通信を管理しない場合、Dockerで直接実行する意味はありません。

Claude Desktopの設定

このMCPサーバーをClaude Desktopで使用するには、次の手順を実行します。

1. Claude Desktopを開き、設定をクリックします。
2. "Developer"セクションに移動します。
3. "Edit Config"をクリックします。
4. claude_desktop_config.jsonファイルを開き、サーバーを構成します。

{
  "mcpServers": {
    "blockscout": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "ghcr.io/blockscout/mcp-server:latest"
      ]
    }
  }
}

5. ファイルを保存し、Claude Desktopを再起動します。
6. Claudeとチャットするときに、Blockscout MCP Serverを有効にすることで、Claudeがブロックチェーンデータにアクセスできるようになります。

📄 ライセンス

このプロジェクトは主にMITライセンスの条件で配布されています。詳細については、LICENSEを参照してください。