🚀 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",
""
]
}
}
}
在 Cursor 中配置
在项目根目录添加 server.json 文件：
{
"mcpServers": {
"zan": {
"command": "npx",
"args": [
"zan-mcp-server",
"--stdio",
"--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- 对于 Solana：
--solana-private-key
项目集成
import { createStdioServer } from 'zan-mcp-server';
// 创建并启动服务器
const server = createStdioServer({
// 配置选项
});
// 处理服务器生命周期事件
开发指南
# 安装依赖项
pnpm install
# 开发模式
pnpm dev:watch
# 构建项目
pnpm build
# 使用 MCP 检查工具进行测试
pnpm inspect
📄 许可证
MIT License 由 Jeason 执笔