Base Network MCP Server

Base Network MCP サーバー

Base Network のブロックチェーンデータにアクセスするための Model Context Protocol（MCP）サーバーです。Base メインネットとテストネット上のブロック、トランザクション、残高、スマートコントラクトを照会するツールを提供します。

機能

• ブロックチェーンツール 9 種類（API キーなしで利用できるものは 7 種類）
• Base メインネットと Sepolia テストネットに対応
• ブロックチェーンデータにリアルタイムでアクセス
• Docker に対応
• 複数のトランスポート方式（stdio、HTTP）

クイックスタート

インストールとビルド

git clone https://github.com/u-Operating-System/basescan-mcp-server.git
cd basescan-mcp-server
npm install
npm run build

サーバーの実行

# For Claude Desktop (recommended)
npm start

# For HTTP server
MCP_TRANSPORT_TYPE=http npm start

オプション：BaseScan API キー

無料の BaseScan API キーを追加すると、拡張機能を利用できます。

1. https://basescan.org/apis にアクセスします
2. アカウントを作成し、API キーを取得します
3. 環境変数に追加します：BASESCAN_API_KEY=your-key

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "base-network": {
      "command": "node",
      "args": ["/path/to/basescan-mcp-server/build/index.js"],
      "env": {
        "BASESCAN_API_KEY": "your-key-here"
      }
    }
  }
}

Docker

# Basic setup
docker run -p 3010:3010 basescan-mcp-server

# With API key
docker run -p 3010:3010 -e BASESCAN_API_KEY=your-key basescan-mcp-server

利用可能なツール

ツール	説明	API キーが必要
get_latest_block	最新ブロックの情報	いいえ
get_block	番号またはハッシュによるブロックの取得	いいえ
get_transaction	トランザクションの詳細	いいえ
get_balance	ETH 残高の照会	いいえ
get_gas_price	現在のガス価格	いいえ
check_contract	スマートコントラクトの検出	いいえ
get_network_stats	ネットワーク統計	いいえ
get_account_transactions	アカウントのトランザクション履歴	はい
get_account_tokens	トークンの送金履歴	はい

設定

環境変数で設定します：

NODE_ENV=development              # development|production
MCP_TRANSPORT_TYPE=stdio          # stdio|http
MCP_HTTP_PORT=3010               # HTTP port
BASESCAN_API_KEY=your-key        # BaseScan API key (optional)
MCP_LOG_LEVEL=info               # debug|info|warning|error

セキュリティ

• API キーは環境変数に保存してください
• 実際の値を含む .env ファイルをコミットしないでください
• 本番環境では HTTPS を使用してください

ネットワーク

• Base メインネット：チェーン ID 8453
• Base Sepolia：チェーン ID 84532

開発

npm run dev            # Development with hot reload
npm test               # Run tests
npm run lint           # Code linting
npm run format         # Code formatting

ライセンス

MIT