ZAN MCP Server

ZAN MCP 服务

适用于 ZAN.top 节点服务的模型上下文协议服务。

简介

ZAN MCP 服务是基于模型上下文协议规范实现的服务，专为 ZAN.top 区块链节点服务设计。它提供各种区块链交互工具和接口，使 AI 助手能够通过 MCP 协议无缝访问和处理区块链数据。

功能

• 多链支持：支持多种兼容 EVM 的链，包括 Ethereum、Polygon、BSC、Arbitrum 和 Optimism
• 便捷的区块链查询：提供区块链信息、地址解析等功能
• 高可靠性节点服务：基于 ZAN.top 的高性能节点服务
• 标准 MCP 协议：完全符合模型上下文协议规范
• 可扩展架构：支持轻松添加新的区块链工具和服务

支持的区块链

• 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：估算交易所需的 gas
• evm_get_gas_price：获取当前 gas 价格
• 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：准备包含 gas 和 nonce 的交易请求
• evm_send_raw_transaction：发送已签名的原始交易
• evm_send_transaction：签署并发送交易

ZAN 高级 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 许可证