blockscout-mcp-server

読み取り専用の stdio MCP サーバー。Blockscout REST API を通じて、AI エージェントにマルチチェーン EVM のオンチェーンデータ（アドレス、トランザクション、ブロック、ログ、トークン、NFT、コントラクトのソースコード）を提供します。

[!IMPORTANT] これは 公式の Blockscout MCP サーバー ではありません。個人開発者が独自に構築・保守しているカスタムサーバーであり、Blockscout チームとは無関係で、その承認も受けていません。

クイックスタート

npx が公開済みパッケージをダウンロードして実行します。手動でのインストールは不要です。任意のプロジェクトから動作し、CHAINS_FILE をそのプロジェクトのチェーン設定ファイルに指定します（相対パス ./chains.json はクライアントの作業ディレクトリ基準で解決されます）。

{
  "mcpServers": {
    "blockscout": {
      "command": "npx",
      "args": ["-y", "blockscout-mcp-server"],
      "env": {
        "CHAINS_FILE": "./chains.json",
        "ONLY_CHAINS_FILE": "true"
      }
    }
  }
}

チェーンレジストリと環境変数は起動時に一度だけ読み込まれます。設定やコードを変更した後は、MCP クライアント内でサーバーを再起動（再接続）してください。編集可能な .mcp.example.json が同梱されています。

Related MCP server: Onesource MCP

対応チェーン

これらのチェーンは、同梱のスナップショット（src/chains/bundled.json）から追加設定なしで登録されます。任意のツールの chain 引数には、チェーン名（ethereum）または数値のチェーン ID（1）のどちらも指定できます。

get_chains_list ツールを呼び出すと、実行中のサーバーに実際に登録されているチェーンを確認できます。

カスタムチェーン

CHAINS_FILE に、追加のチェーン（または同梱チェーンの上書き）を記述した JSON ファイルを指定します。各エントリには、name、chainId、および Blockscout インスタンスの url が必要です：

[
  { "name": "my-l2", "chainId": 42, "url": "https://scan.my-l2.io" }
]

CHAINS_FILE が設定されているのにファイルが存在しない、または不正な形式の場合、サーバーは即座に終了します（フェイルファスト）。

ONLY_CHAINS_FILE=true を設定すると、CHAINS_FILE のチェーンのみが登録され、同梱スナップショットは完全に除外されます。この場合 CHAINS_FILE の設定が必須です（設定しないとチェーンが存在せず、サーバーはフェイルファストします）。デフォルト（false）では、同梱チェーンと CHAINS_FILE のチェーンがマージされます。

ローカル開発

MCP Inspector が開発依存関係として組み込まれているため、実際のクライアントにサーバーを接続しなくても、MCP ハンドシェイクを確認したり、ツールを手動で呼び出したりできます。

git clone https://github.com/imelon2/blockscout-mcp-server.git
cd blockscout-mcp-server
pnpm install
pnpm run inspect

pnpm run inspect は最初にビルドを実行し、その後 Inspector UI を開きます。stdio トランスポートを選択し、node dist/index.js を指定してください。2つのショートカット：

ライセンス

MIT