项目介绍
ZAN MCP Server

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
示例

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