区块链节点服务协议服务器

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

  • by jeasonstudio
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 jeasonstudio/zan-mcp-server

使用说明

ZAN MCP服务器

模型上下文协议服务器 ZAN.top 节点服务。

引言

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

特性

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

支持的区块链

  • 以太坊:主网、Sepolia、Holesky测试网络
  • BSC:主网、测试网
  • 多边形:主网、厦门测试网
  • 乐观主义:主网、Sepolia测试网
  • 仲裁:一个(主网),Sepolia测试网
  • 其他:Base、zkSync、Tron、Avalanche、Fantom、Taiko、Mantle

演示

API

资源

  • EVM链服务:为以太坊虚拟机兼容链提供接口
  • 高级API服务:提供高级Web3 API服务
  • 索拉纳连锁服务:(即将推出)将为Solana区块链操作提供接口

工具

EVM工具

  • evm_get_chain_info:获取特定EVM网络的信息
  • evm_resolve_ens:解析以太坊名称服务(ENS)域
  • evm_get_supported_网络:获取所有支持的网络列表
  • evm_get_contract_address:获取已部署的智能合约地址信息
  • evm_get_address:获取当前使用的以太坊地址
  • evm_create_access_list:为事务创建访问列表
  • evm_get_balance:获取账户余额
  • evm_get_transaction_count:获取地址的交易数量(nonce)
  • evm_get_block:通过块编号或哈希值获取块信息
  • evm_get_block_编号:获取最新的区块编号
  • evm_get_block_transaction_count:获取一个区块中的交易数量
  • evm_call:执行智能合约调用
  • evm_estimate_gas:估算交易所需的天然气
  • evm_get_gas_price:获取当前天然气价格
  • evm_verify_message:验证已签名的消息
  • evm_verify_typed_data:验证键入的数据签名
  • evm_get_交易:获取交易详细信息
  • evm_get_transaction_receipt:获取交易收据
  • evm_get_logs:获取符合特定筛选条件的日志
  • evm_get_addresses:获取可用帐户地址列表
  • evm_sign_message:签署消息
  • evm_sign_typed_data:验证键入的数据签名
  • evm_sign_交易:签署交易而不发送
  • evm_prepare_transaction_request:使用gas和nonce准备交易请求
  • evm_send_raw_transaction:发送原始签名交易
  • evm_send_transaction:签署并发送交易

ZAN高级API工具

  • zan_evm_get_nft元数据:获取特定NFT合约地址的元数据
  • zan_evm_get_nfts_by_owner:获取特定钱包地址拥有的NFT
  • zan_evm_get_nft_id:获取NFT合约地址的令牌ID列表

即将到来的区块链支持

  • Solana工具:Solana区块链交互工具(开发中)
  • 比特币工具比特币区块链交互工具(计划)
  • Aptos工具:Aptos区块链交互工具(计划中)
  • 隋工具:穗区块链交互工具(计划中)

用法

克劳德桌面

将此添加到您的 claude_desktop_config.json:

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

光标

{
  "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-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