Zan MCP Server

🚀 ZAN MCP サーバ

モデルコンテキストプロトコル（Model Context Protocol）に基づくサーバ実装で、ZAN.top ブロックチェーンノードサービスに特化して設計されています。様々なツールとインターフェースを提供し、ブロックチェーンとの相互作用を容易にし、AI アシスタントが MCP プロトコルを通じてブロックチェーンデータにアクセスし処理できるようにします。

🚀 クイックスタート

ZAN MCP Server は、モデルコンテキストプロトコル仕様に基づくサーバ実装で、ZAN.top ブロックチェーンノードサービスに特化して設計されています。様々なツールとサービスインターフェースを提供し、ブロックチェーン情報の照会やアドレス解析などの機能をサポートし、AI アシスタントが MCP プロトコルを通じて簡単にブロックチェーンデータにアクセスし処理できるようにします。

✨ 主な機能

• マルチチェーン対応：複数のブロックチェーンネットワークをサポート
• 機能豊富：包括的なブロックチェーン操作インターフェースを提供
• 高効率で信頼性高い：パフォーマンスを最適化し、安定した動作を保証
• 統合が容易：シンプルな API 設計で、プロジェクトへの統合が容易

📚 ドキュメント

サポートされるブロックチェーン

ZAN MCP Server は現在、以下のブロックチェーンネットワークをサポートしています。

EVM タイプのチェーン

• イーサリアム (Ethereum)
• バイナンススマートチェーン (Binance Smart Chain)
• Polygon ネットワーク

その他のタイプのチェーン

• ソラナ (Solana)
• トロン (TRON)
• Cosmos SDK チェーン

注意事項

⚠️ 重要提示

画像の例については、原文のリンクを参照してください。

API インターフェース

ZAN MCP Server は、開発者がブロックチェーンとの相互作用を容易にするための豊富な API インターフェースを提供します。インターフェースは以下のカテゴリに分けられます。

リソース

• ブロックチェーン情報照会：チェーンの基本情報やノードの状態などを取得
• トランザクション照会：特定のトランザクションの詳細情報を検索
• アドレス残高照会：指定されたアドレスの資産残高を確認

サービスツール

EVM ツール

// サンプルコード
const { createEvmService } = require('zan-mcp-server');

const evmService = createEvmService({
  chainId: '0x1', // Ethereum メインネット
  privateKey: 'your-private-key'
});

// 残高を取得
async function getBalance(address) {
  return await evmService.getBalance(address);
}

Solana ツール

const { createSolanaService } = require('zan-mcp-server');

const solanaService = createSolanaService({
  endpoint: 'https://api.mainnet-beta.solana.com',
  privateKey: 'your-base58-private-key'
});

// トランザクションを送信
async function sendTransaction(from, to, amount) {
  return await solanaService.sendTx(from, to, amount);
}

設定例

Claude Desktop での設定

config.json ファイルに以下の内容を追加します。

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

Cursor での設定

プロジェクトのルートディレクトリに server.json ファイルを追加します。

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

VSCode での設定

settings.json に以下の内容を追加します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "zan_api_key",
      "description": "ZAN ノードサービス API キー",
      "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 <base58-private-key>

プロジェクトへの統合

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

// サーバを作成して起動
const server = createStdioServer({
  // 設定オプション
});

// サーバのライフサイクルイベントを処理

開発ガイド

# 依存関係をインストール
pnpm install

# 開発モード
pnpm dev:watch

# プロジェクトをビルド
pnpm build

# MCP チェックツールを使用してテスト
pnpm inspect

📄 ライセンス

Jeason が執筆した MIT License