mcpField
B
Blockscout

Blockscout

リモート
blockscout.com金融データ467 週間前に更新

Blockscout について

Blockscout MCP Server は、残高、トークン、NFT、コントラクトメタデータなどのブロックチェーンデータを AI エージェントや IDE に提供します。オンチェーン情報を分析するユーザー向けで、コンテキスト最適化により LLM のトークン使用量を抑えます。

主な機能

  1. 01アドレスの残高、トークン保有量、NFT の参照
  2. 02Chainscout メタデータを用いたマルチチェーン対応
  3. 03カーソルによるページネーションと大きなフィールドの自動切り詰め
  4. 04全 MCP ツールに対応するバージョン管理された REST API
  5. 05長時間の処理に対する進捗通知

活用シーン

  1. 01指定期間におけるアドレスのトランザクションとトークン転送の確認
  2. 02検証済みスマートコントラクトの ABI とソースファイルの取得
  3. 03エージェント内での ENS 名からイーサリアムアドレスへの変換

MCP 対応

このプロジェクトは MCP サーバーであり、Claude や Cursor などの MCP クライアントに 16 種類のブロックチェーン照会ツールを公開します。ホスト型エンドポイント mcp.blockscout.com の利用には Blockscout PRO API キーが必要です。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.blockscout.com/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

16

このツールにパラメーターはありません。

詳細

Blockscout MCP サーバー

smithery badge

Blockscout Server MCP server

Model Context Protocol(MCP)は、AI エージェント、IDE、自動化ツールが、コンテキストを考慮した API を通じて構造化データを利用、照会、分析できるように設計されたオープンプロトコルです。

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

主な機能:

  • AI ツールがブロックチェーンデータにコンテキストに応じてアクセス
  • Chainscout のメタデータ拡充を伴う Blockscout PRO API 設定によるマルチチェーン対応
  • バージョン管理された REST API:すべての MCP ツールに標準的でウェブに適したインターフェースを提供します。詳細なドキュメントについては、API.md を参照してください。
  • MCP ホストがサーバーを利用するためのカスタム指示
  • データへのアクセス性を維持しながら LLM トークンを節約する、インテリジェントなコンテキスト最適化
  • コンテキストのオーバーフローを防ぐ、設定可能なページサイズによるスマートなレスポンス分割
  • 複雑なパラメーターの代わりに Base64URL エンコード文字列を使用する、不透明なカーソルによるページネーション
  • 大きなデータフィールドを自動的に切り詰め、明確な表示とアクセス方法の案内を提供
  • 構造化 JSON レスポンスと後続の指示を備えた、標準化された ToolResponse モデル
  • 長時間実行される処理向けの MCP 進捗通知と定期的な更新による、可観測性の強化

エージェントスキルによる分析の強化

より強力で効率的なブロックチェーン分析を行うには、agent-skills repository から Blockscout Analysis スキルをインストールしてください。このスキルは、実行戦略、レスポンスの処理、セキュリティのベストプラクティス、ワークフローのオーケストレーションに関する体系的なガイダンスを AI エージェントに提供します。

詳細情報:agent-skills README で、すべての機能とインストール手順を確認してください。

MCP クライアントの設定

Blockscout PRO API キー

Blockscout MCP サーバーを AI エージェントで使用するには、Blockscout PRO API キーの設定が必要です。データツールの大半は認証済みの Blockscout PRO API ゲートウェイ経由でリクエストを送信するため、有効なキーがない場合、上流へのリクエストを行う前にこれらのツールはすぐに失敗します。

キーを取得するには、Blockscout Developer Portal に登録し(無料プランではクレジットカードは不要です)、API キーを生成してください。キーのプレフィックスは proapi_ です。その後、以下のセクションに示すように、クライアントの設定時にキーを指定してください。

Claude のセットアップ(Web、Desktop、Cowork)— 推奨

Claude で Blockscout MCP サーバーを使う最も簡単な方法は、公式ホスト型サーバーを利用することです。自分で実行するものはなく、自動更新に対応した、ネイティブのマネージドインストール環境です。独自の PRO API キーを使ってカスタムコネクタとして追加します。Claude は各リクエストでキーを x-api-key ヘッダーに含めて送信し、サーバーはこのヘッダーを Blockscout-MCP-Pro-Api-Key ヘッダーの別名として受け付けます。

  1. Claude を開き、カスタマイズ > コネクタに移動します。Team プランと Enterprise プランでは、組織のオーナーが組織の設定 > コネクタから操作します。
  2. カスタムコネクタを追加をクリックします。名前に Blockscout、URL に https://mcp.blockscout.com/mcp を設定し、続行します。
  3. 認証は None のままにします(Claude が検出します)。コネクタに認証情報がないという警告が表示されるのは想定どおりです。キーは次の手順で指定します。
  4. リクエストヘッダーを開き、リストから x-api-key を選択して、値として PRO API キーを貼り付けます。必ずこの名前を選択してください。サーバーはリストにある、名前が似ている他の項目を読み取りません。
  5. 追加をクリックします。

注: リクエストヘッダーセクションはベータ版で、まだすべての組織で利用できるわけではありません。ダイアログに表示されない場合は、以下のClaude コネクタディレクトリの使用を利用してください。

注: Team プランと Enterprise プランでは、オーナーがキーを一度入力すると、組織全体で共有されます。コネクタの追加後は認証設定を編集できません。キーを変更するには、コネクタを削除して再度追加してください。

Claude コネクタディレクトリの使用

カスタムコネクタのダイアログにリクエストヘッダーセクションがない場合は、公式のAnthropic コネクタディレクトリから Blockscout コネクタをインストールしてください。同じホスト型サーバーに接続しますが、共有アクセスキーを使用します。

インストール
オプション 1:直接リンク

claude.com/connectors/blockscoutにアクセスし、「使用先」セクションのリンクをクリックして Blockscout コネクタをインストールします。

オプション 2:設定から
  1. Claude(Web または Desktop アプリ)を開きます
  2. 設定 > コネクタ > コネクタを参照に移動します
  3. 「Blockscout」を検索します
  4. 「接続」をクリックしてインストールします

制限事項: 共有アクセスキーを使用するため、コネクタへのアクセスや機能が制限される場合があります。

Claude Code のセットアップ

サーバーの追加時に、Blockscout-MCP-Pro-Api-Key ヘッダーで PRO API キーを渡します。

claude mcp add --transport http blockscout https://mcp.blockscout.com/mcp \
  --header "Blockscout-MCP-Pro-Api-Key: proapi_your_key_here"

このコマンドを実行すると、Blockscout が Claude Code の MCP サーバーとして利用可能になり、コーディング環境から直接ブロックチェーンデータにアクセスして分析できるようになります。

ChatGPT Apps のセットアップ

ChatGPT Apps マーケットプレイスから Blockscout アプリをインストールします。

  1. Blockscout アプリのページを開きます(またはChatGPT Apps ディレクトリで「Blockscout」を検索します)。
  2. 「接続」をクリックして、ChatGPT アカウントでアプリを有効にします。
Codex アプリのセットアップ
  1. Codex を開き、設定 > MCP サーバー > サーバーを追加に移動します。
  2. 名前に Blockscout を設定し、Streamable HTTP タブを選択して、URLに https://mcp.blockscout.com/mcp を設定します。
  3. ヘッダーで、キーが Blockscout-MCP-Pro-Api-Key、値が proapi_your_key_here のヘッダーを追加します。
  4. 保存して Codex アプリを再起動します。
Codex CLI のセットアップ

Codex CLI ではコマンドラインからカスタムヘッダーを設定できないため、次の 2 つの手順で設定します。

  1. サーバーエントリーのひな形を作成します。

    codex mcp add Blockscout --url https://mcp.blockscout.com/mcp
    
  2. ~/.codex/config.toml を編集して PRO API キーヘッダーを追加し、streamable-HTTP MCP クライアントを有効にします(リモート MCP サーバーへの接続に必要です)。設定後は次のようになります。

    [features]
    experimental_use_rmcp_client = true
    
    [mcp_servers.Blockscout]
    url = "https://mcp.blockscout.com/mcp"
    http_headers = { "Blockscout-MCP-Pro-Api-Key" = "proapi_your_key_here" }
    
Cursor のセットアップ

Blockscout-MCP-Pro-Api-Key ヘッダーを使って PRO API キーを指定し、Cursor の MCP 設定(プロジェクトレベルの .cursor/mcp.json またはグローバルな ~/.cursor/mcp.json)にサーバーを追加します。

{
  "mcpServers": {
    "blockscout": {
      "url": "https://mcp.blockscout.com/mcp",
      "timeout": 180000,
      "headers": {
        "Blockscout-MCP-Pro-Api-Key": "proapi_your_key_here"
      }
    }
  }
}
ローカル開発環境のセットアップ(開発者向け)

開発目的でサーバーをローカルで実行する場合は、次の手順に従います。

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

技術的な詳細

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

リポジトリ構成

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

テスト

単体テストと統合テストの両方の実行方法について詳しくは、TESTING.md を参照してください。

ツールの説明

  1. __unlock_blockchain_analysis__() - Blockscout MCP セッションを初期化します。サーバーの参照データ、blockscout-analysis スキルへのポインター、URI 解決ルールを返します。他のツールを呼び出す前に、セッションごとに一度だけ呼び出してください。
  2. get_chains_list(query=None) - サポートされているチェーンの一覧を返します。名前、チェーン ID、ネイティブ通貨、エコシステムによる絞り込みを任意で指定できます。
  3. get_address_by_ens_name(name) - ENS ドメイン名を対応する Ethereum アドレスに変換します。
  4. lookup_token_by_symbol(chain_id, symbol) - シンボルまたは名前でトークンアドレスを検索し、候補を複数返します。
  5. get_contract_abi(chain_id, address) - スマートコントラクトの ABI(アプリケーション・バイナリー・インターフェース)を取得します。
  6. inspect_contract_code(chain_id, address, file_name=None) - 検証済みコントラクトのソースファイルを取得できます。
  7. get_address_info(chain_id, address) - 残高、ENS との関連付け、コントラクトの状態、トークンの詳細、公開タグなど、アドレスに関する包括的な情報を取得します。
  8. get_tokens_by_address(chain_id, address, cursor=None) - 拡充されたメタデータと市場データを含む、アドレスが保有する ERC20 トークンの詳細を返します。
  9. get_block_number(chain_id, [datetime]) - 特定の日時、または最新ブロックのブロック番号とタイムスタンプを取得します。
  10. get_transactions_by_address(chain_id, address, age_from, age_to, methods, cursor=None) - 指定した期間内のアドレスのトランザクションを取得します。メソッドによる絞り込みも任意で指定できます。
  11. get_token_transfers_by_address(chain_id, address, age_from, age_to, token, cursor=None) - 指定した期間内のアドレスの ERC-20 トークン送金を返します。
  12. nft_tokens_by_address(chain_id, address, cursor=None) - アドレスが所有する NFT トークンをコレクション別にまとめて取得します。
  13. get_block_info(chain_id, number_or_hash, include_transactions=False) - タイムスタンプ、使用ガス量、バーンされた手数料、トランザクション数など、ブロック情報を返します。トランザクションハッシュの一覧も任意で含められます。
  14. get_transaction_info(chain_id, hash, include_raw_input=False) - デコード済みの入力パラメーターと詳細なトークン送金を含む、トランザクションの包括的な情報を取得します。
  15. read_contract(chain_id, address, abi, function_name, args='[]', block='latest') - スマートコントラクトの読み取り専用関数を実行し、その結果を返します。abi 引数は、対象の関数シグネチャを記述する JSON オブジェクトです。
  16. direct_api_call(chain_id, endpoint_path, query_params=None, cursor=None, method='GET', json_body=None) - 高度なデータやチェーン固有のデータを取得するため、Blockscout API のエンドポイントを直接呼び出します。JSON 本文を指定した GET(デフォルト)および POST リクエストに対応しています。

AI エージェント向けのプロンプト例

Is any approval set for OP token on Optimism chain by `zeaver.eth`?
Calculate the total gas fees paid on Ethereum by address `0xcafe...cafe` in May 2025.
Which 10 most recent logs were emitted by `0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7`
before `Nov 08 2024 04:21:35 AM (-06:00 UTC)`?
Tell me more about the transaction `0xf8a55721f7e2dcf85690aaf81519f7bc820bc58a878fa5f81b12aef5ccda0efb`
on Redstone rollup.
Is there any blacklisting functionality of USDT token on Arbitrum One?
What is the latest block on Gnosis Chain and who is the block minter?
Were any funds moved from this minter recently?
When the most recent reward distribution of Kinto token was made to the wallet
`0x7D467D99028199D99B1c91850C4dea0c82aDDF52` in Kinto chain?
Which methods of `0x1c479675ad559DC151F6Ec7ed3FbF8ceE79582B6` on the Ethereum 
mainnet could emit `SequencerBatchDelivered`?
What is the most recent executed cross-chain message sent from the Arbitrum Sepolia
rollup to the base layer?

開発とデプロイ

ローカルインストール

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

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

RPC リクエストで使用する User-Agent ヘッダーの先頭部分をカスタマイズするには、 BLOCKSCOUT_MCP_USER_AGENT 環境変数を設定します(デフォルトは "Blockscout MCP" です)。サーバーのバージョンは自動的に末尾に追加されます。

サーバーへの PRO API キーの提供

サーバーを自分で実行する場合は、Blockscout PRO API キーをBLOCKSCOUT_PRO_API_KEY環境変数で指定してください。シェルでエクスポートするか、プロジェクトのルートにある Git の追跡対象外の.envファイルに記述します。これにより、すべてのデータへのアクセス、公開タグによる情報補完、コントラクトの読み取りが有効になります。キーをコミットしたり、クライアントに配布するバイナリに埋め込んだりしないでください。Docker 経由で実行する場合は、イメージに組み込まず、実行時に渡してください(例:-e BLOCKSCOUT_PRO_API_KEY=...)。

export BLOCKSCOUT_PRO_API_KEY=proapi_your_key_here

クライアントが提供するキー(HTTP トランスポート)。 サーバーを HTTP モードで実行している場合、クライアントはリクエストヘッダーで独自の PRO API キーを指定できます。デフォルトのヘッダー名はBlockscout-MCP-Pro-Api-Keyで、BLOCKSCOUT_PRO_API_KEY_HEADERで変更できます(クライアントが提供するキーを完全に無効にするには、空文字列を設定します)。また、ヘッダー名が固定リストに制限されているクライアント(Claude Custom Connectors など)向けに、サーバーはx-api-keyヘッダーからもキーを読み取ります。両方のヘッダーがある場合は、設定されたヘッダーが優先されます。x-api-keyは、設定されたヘッダーがないか空の場合にのみ参照され、クライアントが提供するキーを無効にすると、こちらも無効になります。これは、MCP-over-HTTP のツール呼び出しと REST API の両方で、いずれの HTTP トランスポートでも同じように機能します。クライアントが提供するキーは、そのリクエストではBLOCKSCOUT_PRO_API_KEYより優先されます。クライアントがキーを送信しない場合、サーバーは自身に設定されたキーを使用します。どちらもない場合、リクエストは未設定エラーで失敗します。クライアントのキーが指定されていても形式が不正な場合、PRO API を必要とするリクエストはフォールバックなしで失敗します(サーバーが不正なクライアントキーの代わりに自身のキーを暗黙的に使用することはありません)。PRO API を使用しないツールには影響しません。これにより、各クライアントが独自のキーで認証する共有 HTTP サーバーを運用できます。

残高低下の警告。 PRO API へのアクセスではクレジットが消費されます。API が報告する残高が設定可能なしきい値を下回ると、すべてのデータツールが応答に注意書きを追加し、PRO API へのアクセスを継続的な大量利用に備えて維持できるよう、運用担当者にクレジットの追加を促します。しきい値はBLOCKSCOUT_PRO_API_LOW_CREDITS_THRESHOLDで設定します(デフォルトは5000クレジットです。注意書きを無効にするには0を設定します)。残高がゼロまたはマイナスの場合も含め、しきい値を下回る残高に対して注意書きが表示されます。

PRO API キー必須の通知。 BLOCKSCOUT_PRO_API_KEY_REQUIRED_NOTICEには、クライアント独自の(形式が正しい)PRO API キーをリクエストに含めなかった場合に、サーバーがツール応答のnotesフィールドの最後に追加する、運用担当者が設定した通知文を指定します。これは、公式公開サーバーがクライアントによるキー提供を必須にする移行を告知するためのものです。そのため、これを設定するのは公式のデプロイメントのみを想定しています。この変数が未設定または空の場合(デフォルト)、機能は完全に無効になります。コミュニティ運用者やセルフホストの運用者は空のままにしてください。特に stdio モードでは、自分でBLOCKSCOUT_PRO_API_KEYを設定し、リクエストヘッダーにクライアントキーを含めることもできないため、この通知を設定しても、デプロイメントには適用されない移行メッセージが繰り返されるだけです。

サーバーの実行

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

python -m blockscout_mcp_server

HTTP モード(MCP のみ):

サーバーを HTTP Streamable モード(ステートレス、デフォルトで SSE レスポンス)で実行するには、次のようにします。

python -m blockscout_mcp_server --http

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

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

開発モード(プレーンな JSON レスポンス):

シンプルな HTTP クライアント(curl、Insomnia)を使った開発やテストでは、SSE ストリームの代わりにプレーンな JSON レスポンスを有効にできます。

export BLOCKSCOUT_DEV_JSON_RESPONSE=true
python -m blockscout_mcp_server --http

注: これにより、Server-Sent Events(SSE)と進捗通知が無効になります。ローカルでのテストとデバッグにのみ使用してください。

Ngrok を使ったトンネリング(開発モード):

Python MCP SDK は DNS リバインディング保護を適用しているため、デフォルトでは ngrok トンネルからのリクエストがブロックされます。開発やテストでトンネリングを有効にするには、次のようにします。

  1. ローカルサーバーへの ngrok トンネルを開始します。

    ngrok http 8000
    
  2. ngrok URL を使って、許可するホストとオリジンを設定します。

    export BLOCKSCOUT_MCP_ALLOWED_HOSTS="your-tunnel-id.ngrok-free.app"
    export BLOCKSCOUT_MCP_ALLOWED_ORIGINS="https://your-tunnel-id.ngrok-free.app"
    python -m blockscout_mcp_server --http
    

注: これらの設定は主に開発用です。これらの変数が設定されていない場合、DNS リバインディング保護はサーバーのバインドホストに基づいて自動的に決まります。localhost では有効になり、localhost 以外(例:0.0.0.0)では無効になります。Host ヘッダーに標準以外のポートが含まれている場合は、:* ワイルドカード接尾辞(例:"example.com:*")を使うか、ホストとポートの値を正確に指定してください。

MCP サーバーを使った ngrok トンネリングの詳細については、OpenAI Apps SDK Examples のドキュメントをご覧ください。

REST API を使う HTTP モード:

MCP エンドポイントとともにバージョン管理された REST API を有効にするには、--rest フラグを使用します(--http が必要です)。

python -m blockscout_mcp_server --http --rest

カスタムホストとポートを指定する場合:

python -m blockscout_mcp_server --http --rest --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)。
  • --rest:REST API を有効にします(--http が必要です)。
Docker イメージをローカルでビルドする

同梱のスキルサブモジュールを初期化し、そのコミットメタデータを Docker ビルドコンテキストに埋め込んでから、イメージをビルドします。

git submodule update --init --recursive agent-skills
python scripts/bake_skill_metadata.py
docker build -t ghcr.io/blockscout/mcp-server:latest .
GitHub Container Registry からプルする

ビルド済みイメージをプルします。

docker pull ghcr.io/blockscout/mcp-server:latest
Docker での実行

HTTP モード(MCP のみ):

ポートマッピングを指定して、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

REST API を使用する HTTP モード:

REST API を有効にして実行します:

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

注: Docker で HTTP モードを実行する場合は、サーバーにコンテナの外部からアクセスできるよう、--http-host 0.0.0.0 を指定してすべてのインターフェースにバインドします。

Blockscout PRO API キーを使用する場合:

イメージにキーを埋め込むのではなく、実行時に -e で渡します(PRO API キーをサーバーに設定するを参照):

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

セッションメータリングを有効にする場合(任意):

セッションメータリングを有効にすると、クライアントから PRO API キーが提供されていない呼び出し元が、__unlock_blockchain_analysis__ によって発行されたセッション識別子ごとに実行できるツール呼び出しの回数を制限できます。デフォルトでは無効です。有効にするには署名シークレット(32 バイト以上。生成してください。自分で考案しないでください)を設定する必要があります。また、HTTP モードとサーバー側の PRO API キー(メータリング対象の呼び出しはそのキーを使って上流で処理されます)、およびセッションデータベース用の永続ボリュームも必要です。シークレットは一度だけ生成し、永続的に保存してください(シークレットマネージャー、または永続的な環境設定を使用します)。再起動や再デプロイのたびに、保存済みの同じ値を渡す必要があります:

# Once, not per start: generate the secret and keep it.
BLOCKSCOUT_SESSION_SECRET="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')"

docker run --rm -p 8000:8000 \
  -v blockscout-mcp-sessions:/data \
  -e BLOCKSCOUT_SESSION_SECRET="$BLOCKSCOUT_SESSION_SECRET" \
  -e BLOCKSCOUT_SESSION_DB_PATH=/data/sessions.db \
  -e BLOCKSCOUT_PRO_API_KEY=proapi_your_key_here \
  ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0

ほとんどのデプロイでは、これらは不要です。BLOCKSCOUT_SESSION_SECRET は設定せず(デフォルト)、ボリュームも不要です。ボリュームの消失やシークレットのローテーションにより、存続中のセッション識別子は仕様どおり無効になります。影響範囲は設定済みの TTL によって制限されます。docker run のたびにコマンド内でシークレットを再生成するのは、このローテーションを意図せず実行することになります。データベースのボリュームが残っていても、再起動のたびに存続中の識別子がすべて消去されるため、起動コマンドに生成コマンドを埋め込まないでください。古いデータベースのコピーを復元すると、そこに記録されていた予算が再び有効になります。過去の状態から復元した後は、それが意図的なものでない限り、シークレットをローテーションしてください。任意の設定項目:BLOCKSCOUT_SESSION_MCP_MAX_CALLS と BLOCKSCOUT_SESSION_REST_MAX_CALLS(1 つの識別子で共有するカウンターに対する、インターフェースごとの呼び出し上限。どちらもデフォルトは 5。0 にすると、そのインターフェースでのメータリング対象アクセスを停止しますが、識別子の発行と get_chains_list によるナビゲーションは引き続き利用できます)、BLOCKSCOUT_SESSION_TTL_SECONDS(デフォルトは 900)、BLOCKSCOUT_SESSION_SWEEP_INTERVAL_SECONDS(期限切れセッション行をクリーンアップする間隔。デフォルトは TTL ごとに 1 回)。

Stdio モード: デフォルトの stdio モードは、MCP ホスト/クライアント(Claude Desktop、Cursor など)での使用を想定して設計されています。通信を管理する MCP クライアントなしで Docker から直接実行しても意味がありません。

Claude Desktop でのテスト

MCP バンドルを使用して、Claude Desktop でサーバーをテストします。

  1. mcpb/README.md の手順に従ってバンドルをビルドします。
  2. Claude Desktop を開きます。
  3. blockscout-mcp-dev.mcpb ファイルをダブルクリックして開き、バンドルを自動的にインストールします。
  4. プロンプトが表示されたら、Blockscout MCP Server の URL を設定します(デフォルト:http://127.0.0.1:8000/mcp)。

プライバシーと匿名テレメトリー

Blockscout MCP Server の改善に役立てるため、コミュニティが運営するサーバーのインスタンスでは、デフォルトで匿名の使用状況データを収集しています。これにより、どのツールが最もよく使われているかを把握し、開発の取り組みの指針にできます。

収集するデータ:

  • 呼び出されたツールの名前(例:get_block_number)。
  • ツールに渡されたパラメーター(session_id パラメーターは、送信前にプレースホルダーでマスクされます)。
  • 使用されている Blockscout MCP Server のバージョン。
  • リクエストの認証に使用できる PRO API キーがある場合、そのキーの一方向で復元不可能なハッシュ(SHA-256)。これは派生したフィンガープリントのみであり、キーそのものが送信されることはなく、ハッシュから復元することもできません。

収集しないデータ:

  • 個人データ、IP アドレス(中央サーバーは送信元の IP を Mixpanel による位置情報の特定に使用した後、破棄します)、秘密情報や秘密鍵そのものは収集しません。特に PRO API キーが送信されることはありません。上記の一方向で復元不可能なフィンガープリントのみが送信され、そこからキーを復元することはできません。
オプトアウトする方法

以下の環境変数を設定すれば、いつでもこの機能を無効にできます。

export BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true

ライセンス

ライセンス:Blockscout Software Licence

このプロジェクトは Blockscout Software Licence の下でライセンスされています。すべての条件については、LICENSE ファイルをご覧ください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。