金大哥 - zan-mcp-server MCP 详情

article

README

🚀 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 执笔

zan-mcp-server