返回市场
赞-MCP服务器

赞-MCP服务器

作者:jeasonstudio2 星标更新:2025-04-18

项目介绍

ZAN MCP Server

NPM 版本

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

简介

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

功能

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

支持的区块链

  • 以太坊:主网、Sepolia、Holesky 测试网络
  • BSC:主网、测试网
  • Polygon:主网、Amoy 测试网
  • Optimism:主网、Sepolia 测试网
  • Arbitrum:One(主网)、Sepolia 测试网
  • 其他:Base、zkSync、Tron、Avalanche、Fantom、Taiko、Mantle

示例

zan-mcp-server-example

API

资源

  • EVM 链服务:提供与EVM兼容链的接口。
  • 高级API服务:提供高级Web3 API服务。
  • Solana 链服务:(即将推出)将提供Solana区块链操作接口。

工具

EVM 工具

  • evm_get_chain_info:获取特定EVM网络的信息。
  • evm_resolve_ens:解析以太坊名称服务(ENS)域名。
  • evm_get_supported_networks:获取所有支持的网络列表。
  • 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_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合约地址的token ID列表。

即将推出的区块链支持

  • Solana 工具:Solana区块链交互工具(正在开发中)
  • 比特币工具:比特币区块链交互工具(计划中)
  • 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 节点服务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 <private-key-base58>

项目集成

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

// 创建并启动服务器
const server = createStdioServer({
  // 配置选项
});

// 处理服务器生命周期

开发

# 安装依赖
pnpm install

# 开发模式
pnpm dev:watch

# 构建
pnpm build

# 使用MCP检查器进行测试
pnpm inspect

许可证

MIT 许可证 by Jeason