使用说明
通用区块链MCP
用于通用区块链开发的综合模型上下文协议(MCP)服务器,通过AI助手提供对ZetaChain CLI、Foundry和跨链功能的完全访问。
特性
🔐 账户管理
- 创建计数:使用助记符短语创建新的ZetaChain帐户
- 进口计数:使用私钥或助记符导入现有帐户
- list_计数:列出所有可用的ZetaChain帐户
- show_计数:显示详细的帐户信息
💰 余额和代币操作
- get_balances:跨链获取本地和ZETA代币余额
- list_tokes:列出所有带有地址和链信息的ZRC-20令牌
- 请求拍卖:从水龙头请求测试网ZETA令牌
🌐 跨链运营
- query_cctx:实时查询跨链交易数据
- get_fees:获取全链和跨链消息费用
- 通话合同:从ZetaChain调用连接链上的合约
- 提款_标记:从ZetaChain提取代币到连接的链
- 提款和取款:在一次操作中提取代币和调用合约
⛓️ 网络与链信息
- list_chains:列出所有支持的链,包括ID和令牌计数
- get_network_info:获取当前ZetaChain网络状态和信息
🛠️ 开发工具
- 创建项目:使用模板创建新的通用合同项目
- check_foundry:验证铸造厂(锻造、铸造、砧座)的安装和版本
🔧 高级工具(65+可用)
- 铸造集成:伪造构建、伪造测试、伪造创建、伪造验证
- 演员操作:cast_call、cast_send、cast_balance、cast_nonce、cast_gas_price
- 铁砧测试:砧_启动,砧_快照,砧_翻转
- ZetaChain高级:validator_create、governance_vote、staking_delegate、staking_rewards
- 交叉链:跨链发送、跨链状态、桥接状态
- 智能合约:合约_堆叠、合约_部署、合约_交互
- DeFi操作:defi\swap、defi_quidity_add、defi_ yield_farm
- NFT操作:nft_mint、nft_transfer、nft_metadata
- 钱包管理:walletexport、walletbackup、transaction_history
- 安全与分析:security_audit、gas_optimizer、multisig_create
- 区块链工具:block_explorer、gas_tracker、portfolio_tracker
备注:通过NPM在本地安装时,高级工具提供完整的功能。云版本提供了有用的指导和安装说明。
安装
🚀 方法1:NPM包(建议用于全功能)
一键安装,自动设置:
npm install -g @ExpertVagabond/universal-blockchain-mcp
这将自动安装:
- ✅ ZetaChain CLI全球
- ✅ 铸造工具包(锻造、铸造、铁砧)
- ✅ 所有65+功能齐全的MCP工具
- ✅ 完整的开发环境
安装后使用:
# Run the MCP server
universal-blockchain-mcp
# Or use with Claude Desktop
# Add to Claude Desktop config:
{
"mcpServers": {
"universal-blockchain": {
"command": "universal-blockchain-mcp",
"args": []
}
}
}
🌐 方法2:Smithery Cloud(托管)
克劳德代码CLI:
claude mcp add --transport http universal-blockchain "https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp"
深度链接(HTTP):
claude://mcp/install?name=Universal%20Blockchain%20MCP&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fserver.smithery.ai%2F%40ExpertVagabond%2Funiversal-blockchain-mcp%2Fmcp%22%7D
手动配置:
{
"type": "http",
"url": "https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp"
}
Smithery登记处:
# Install via Smithery registry
SMITHERY_API_KEY=your_key smithery run @ExpertVagabond/universal-blockchain-mcp
📦 方法3:其他MCP注册表
mcp.so注册表:
- 访问:https://mcp.so
- 搜索:“通用区块链mcp”
- 一键安装可用
PulseMCP目录:
- 访问:https://pulsemcp.com
- 浏览:区块链和Web3类别
- 与Cursor、Claude、Cline直接集成
Glama注册处:
- 访问:https://glama.ai
- 搜索:“ZetaChain”或“区块链”
- 多工具生态系统集成
弗勒(Mac+克劳德):
- 访问:https://fleur.ai
- 零代码MCP安装
- 非常适合非技术用户
🔧 方法4:手动配置
stdio配置(本地):
{
"type": "stdio",
"command": "npx",
"args": ["-y", "@ExpertVagabond/universal-blockchain-mcp"]
}
自定义CLI路径:
{
"type": "stdio",
"command": "/path/to/universal-blockchain-mcp",
"args": []
}
手动安装
先决条件
- Node.js 18+
- ZetaChain命令行界面(自动安装)
- Foundry(用于智能合约开发-自动安装)
快速设置
# Clone and setup everything
git clone https://github.com/ExpertVagabond/zetachain-mcp-server.git
cd zetachain-mcp-server
npm run setup # Installs dependencies, CLI, and builds project
手动设置
# 1. Clone repository
git clone https://github.com/ExpertVagabond/zetachain-mcp-server.git
cd zetachain-mcp-server
# 2. Install dependencies (includes ZetaChain CLI via npm)
npm install
# 3. Install ZetaChain CLI globally (optional, recommended)
npm install -g zetachain@latest
# 4. Build the project
npm run build
# 5. Run the server
npm start
使用本地ZetaChain安装
如果您在本地安装了ZetaChain CLI,则可以指定路径:
export ZETACHAIN_CLI_PATH=/path/to/zetachain
npm start
发展
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Start production server
npm start
使用示例
添加到Claude后,您可以通过自然语言使用所有ZetaChain功能:
账户管理
Create a new ZetaChain account called "my-wallet"
Import my existing account using this private key: 0x...
Show me all my ZetaChain accounts
跨链运营
Check ZETA balances for address 0x742d35Cc6634C0532925a3b8D5C20aE6f0f3FFaa
What are the current cross-chain fees from Ethereum to Polygon?
Query the status of cross-chain transaction 0xabc123...
Withdraw 100 ZETA from ZetaChain to Ethereum address 0x...
代币和链信息
List all supported chains on ZetaChain
Show me all ZRC-20 tokens
What tokens are available on BSC testnet?
发展
Create a new ZetaChain project called "my-dapp"
Get testnet ZETA tokens for address 0x...
What's the current ZetaChain testnet status?
支撑链
ZetaChainMCP服务器支持所有ZetaChain连接的链:
- 以太坊 (Sepolia测试网)
- BSC (测试网)
- 多边形 (厦门测试网)
- 雪崩 (富士测试网)
- 仲裁 (Sepolia)
- 基础 (Sepolia)
- 比特币 (测试网/签名)
- 索拉纳 (Devnet)
- TON (测试网)
- 隋 (测试网)
- Kaia (测试网)
需求
- Node.js 18+
- ZetaChain CLI(作为依赖项自动安装)
- Foundry(用于智能合约开发-自动安装)
建筑
此MCP服务器在AI助手和ZetaChain CLI之间提供了一座桥梁,实现了:
- 直接CLI集成:所有命令都通过官方ZetaChain CLI执行
- 实时数据:来自ZetaChain网络的实时区块链数据
- 跨链功能:完全访问ZetaChain的全链功能
- 开发者工具:项目创建、帐户管理和测试实用程序
许可证
麻省理工学院