Web3 MCP

Web3 MCP

Ankr Advanced API をラップする MCP サーバーの実装です。

概要

FastMCP は、ブロックチェーンデータへのアクセスを提供する Model Context Protocol (MCP) サーバーです。LLM が Ethereum、BSC、Polygon、Avalanche など、複数のチェーンにわたるブロックチェーンデータを操作できるようにします。

MCP クライアントの設定

{
  "mcpServers": {
    "web3": {
      "command": "uvx",
      "args": [
        "web3-mcp"
      ],
      "env": {
        "ANKR_ENDPOINT": "https://rpc.ankr.com/...",
      }
    }
  }
}

機能

• Ankr Advanced API のすべてのエンドポイントを網羅したラッパー
• NFT API：NFT のメタデータ、保有者、転送、所有権情報を取得
• Query API：ブロックチェーンの統計情報、ブロック、ログ、トランザクションデータにアクセス
• Token API：トークン残高、価格、保有者、転送履歴を取得
• 複数のブロックチェーンネットワークに対応

インストール

# Clone the repository
git clone https://github.com/tumf/web3-mcp.git
cd web3-mcp

# Install with uv
uv pip install -e .

設定

次の環境変数を設定します。

# Required
export ANKR_ENDPOINT="your_ankr_rpc_endpoint"

# Optional but recommended for authenticated requests
export ANKR_PRIVATE_KEY="your_private_key"

使用方法

サーバーの実行

from web3_mcp.server import init_server

# Initialize MCP server
mcp = init_server(
    name="Ankr MCP",
    endpoint="your_ankr_endpoint",  # Optional, defaults to ANKR_ENDPOINT env var
    private_key="your_private_key"  # Optional, defaults to ANKR_PRIVATE_KEY env var
)

# Run server
mcp.run()

FastMCP CLI での使用

# Set environment variables first
export ANKR_ENDPOINT="your_ankr_endpoint"
export ANKR_PRIVATE_KEY="your_private_key"

# Run the server
python -m web3_mcp

API カテゴリ

NFT API

• get_nfts_by_owner：ウォレットアドレスが所有する NFT を取得
• get_nft_metadata：特定の NFT のメタデータを取得
• get_nft_holders：特定の NFT コレクションの保有者を取得
• get_nft_transfers：NFT の転送履歴を取得

Query API

• get_blockchain_stats：ブロックチェーンの統計情報を取得
• get_blocks：ブロック情報を取得
• get_logs：ブロックチェーンのログを取得
• get_transactions_by_hash：ハッシュでトランザクションを取得
• get_transactions_by_address：アドレスでトランザクションを取得
• get_interactions：ウォレットとコントラクトのやり取りを取得

Token API

• get_account_balance：ウォレットのトークン残高を取得
• get_currencies：利用可能な通貨を取得
• get_token_price：トークン価格情報を取得
• get_token_holders：トークンの保有者を取得
• get_token_holders_count：トークンの保有者数を取得
• get_token_transfers：トークンの転送履歴を取得

ライセンス

MIT