ZAN MCP Server

ZAN MCP サーバー

ZAN.top のノードサービス向け Model Context Protocol サーバーです。

はじめに

ZAN MCP サーバーは、Model Context Protocol 仕様に基づくサーバー実装で、ZAN.top のブロックチェーンノードサービス向けに特化して設計されています。ブロックチェーンとのやり取りに使えるさまざまなツールとインターフェースを提供し、AI アシスタントが MCP プロトコルを通じてブロックチェーンデータにシームレスにアクセスし、処理できるようにします。

特長

• マルチチェーン対応：Ethereum、Polygon、BSC、Arbitrum、Optimism など、複数の EVM 互換チェーンに対応しています
• 便利なブロックチェーン照会：ブロックチェーン情報やアドレス解決などの機能を提供します
• 高信頼性のノードサービス：ZAN.top の高性能ノードサービスを基盤としています
• 標準 MCP プロトコル：Model Context Protocol 仕様に完全準拠しています
• 拡張可能なアーキテクチャ：新しいブロックチェーンツールやサービスを簡単に追加できます

対応ブロックチェーン

• Ethereum：メインネット、Sepolia、Holesky テストネット
• BSC：メインネット、テストネット
• Polygon：メインネット、Amoy テストネット
• Optimism：メインネット、Sepolia テストネット
• Arbitrum：One（メインネット）、Sepolia テストネット
• その他：Base、zkSync、Tron、Avalanche、Fantom、Taiko、Mantle

デモ

API

リソース

• EVM チェーンサービス：Ethereum Virtual Machine 互換チェーン用のインターフェースを提供します
• 高度な API サービス：高度な Web3 API サービスを提供します
• Solana チェーンサービス：（近日公開）Solana ブロックチェーン操作用のインターフェースを提供する予定です

ツール

EVM ツール

• evm_get_chain_info：特定の EVM ネットワークの情報を取得します
• evm_resolve_ens：Ethereum Name Service（ENS）ドメインを解決します
• evm_get_supported_networks：対応しているすべてのネットワークの一覧を取得します
• evm_get_contract_address：デプロイ済みスマートコントラクトのアドレス情報を取得します
• evm_get_address：現在使用中の Ethereum アドレスを取得します
• evm_create_access_list：トランザクション用のアクセスリストを作成します
• evm_get_balance：アカウント残高を取得します
• evm_get_transaction_count：アドレスのトランザクション数（nonce）を取得します
• evm_get_block：ブロック番号またはハッシュでブロック情報を取得します
• evm_get_block_number：最新のブロック番号を取得します
• evm_get_block_transaction_count：ブロック内のトランザクション数を取得します
• evm_call：スマートコントラクト呼び出しを実行します
• evm_estimate_gas：トランザクションに必要なガスを推定します
• evm_get_gas_price：現在のガス価格を取得します
• evm_verify_message：署名済みメッセージを検証します
• evm_verify_typed_data：型付きデータの署名を検証します
• evm_get_transaction：トランザクションの詳細を取得します
• evm_get_transaction_receipt：トランザクションレシートを取得します
• evm_get_logs：指定したフィルター条件に一致するログを取得します
• evm_get_addresses：利用可能なアカウントアドレスの一覧を取得します
• evm_sign_message：メッセージに署名します
• evm_sign_typed_data：型付きデータの署名を検証します
• evm_sign_transaction：送信せずにトランザクションに署名します
• evm_prepare_transaction_request：ガスと nonce を含むトランザクションリクエストを準備します
• evm_send_raw_transaction：署名済みの raw トランザクションを送信します
• evm_send_transaction：トランザクションに署名して送信します

ZAN Advanced API ツール

• zan_evm_get_nft_metadata：特定の NFT コントラクトアドレスのメタデータを取得します
• zan_evm_get_nfts_by_owner：特定のウォレットアドレスが所有する NFT を取得します
• zan_evm_get_nft_ids：NFT コントラクトアドレスのトークン ID 一覧を取得します

今後のブロックチェーン対応

• Solana ツール：Solana ブロックチェーンとの連携ツール（開発中）
• Bitcoin ツール：Bitcoin ブロックチェーンとの連携ツール（予定）
• Aptos ツール：Aptos ブロックチェーンとの連携ツール（予定）
• Sui ツール：Sui ブロックチェーンとの連携ツール（予定）

使用方法

Claude Desktop

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "zan": {
      "command": "npx",
      "args": [
        "-y",
        "zan-mcp-server",
        "--stdio",
        "--api-key",
        "<zan_api_key>"
      ]
    }
  }
}

Cursor

{
  "mcpServers": {
    "zan": {
      "command": "npx",
      "args": [
        "-y",
        "zan-mcp-server",
        "--stdio",
        "--api-key",
        "<zan_api_key>"
      ]
    }
  }
}

VSCode

{
  "inputs": [
    {
      "type": "promptString",
      "id": "zan_api_key",
      "description": "ZAN Node Service API Key",
      "password": false
    }
  ],
  "servers": {
    "zan": {
      "command": "npx",
      "args": [
        "zan-mcp-server",
        "--stdio",
        "--api-key",
        "${input:zan_api_key}"
      ]
    }
  }
}

注：トランザクションの送信やメッセージの署名などの書き込み操作を行うには、対応するチェーンの秘密鍵を指定する必要があります。

• EVM チェーンの場合：--evm-private-key <private-key>
• Solana の場合：--solana-private-key <private-key-base58>

プロジェクトへの統合

import { createStdioServer } from 'zan-mcp-server';

// Create and start server
const server = createStdioServer({
  // Configuration options
});

// Handle server lifecycle

開発

# Install dependencies
pnpm install

# Development mode
pnpm dev:watch

# Build
pnpm build

# Test with MCP inspector
pnpm inspect

ライセンス

Jeason による MIT License