Zan MCP Server

🚀 ZAN MCP 服務器

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

📄 許可證

MIT License 由 Jeason 執筆