universal-blockchain

通用区块链 MCP

一款功能全面的模型上下文协议（MCP）服务，为通用区块链开发提供支持，可通过 AI 助手完整使用 ZetaChain CLI、Foundry 和跨链功能。

功能

🔐 账户管理

• create_account：使用助记词创建新的 ZetaChain 账户
• import_account：使用私钥或助记词导入现有账户
• list_accounts：列出所有可用的 ZetaChain 账户
• show_account：显示详细的账户信息

💰 余额与代币操作

• get_balances：获取各链上的原生代币和 ZETA 代币余额
• list_tokens：列出所有 ZRC-20 代币及其地址和链信息
• request_faucet：从水龙头申请测试网 ZETA 代币

🌐 跨链操作

• query_cctx：实时查询跨链交易数据
• get_fees：获取全链和跨链消息费用
• call_contract：通过 ZetaChain 调用已连接链上的合约
• withdraw_tokens：从 ZetaChain 向已连接的链提取代币
• withdraw_and_call：在一次操作中提取代币并调用合约

⛓️ 网络与链信息

• list_chains：列出所有受支持的链及其 ID 和代币数量
• get_network_info：获取当前 ZetaChain 网络状态和信息

🛠️ 开发工具

• create_project：使用模板创建新的通用合约项目
• check_foundry：检查 Foundry（forge、cast、anvil）的安装情况和版本

🔧 高级工具（65+ 项）

• Foundry 集成：forge_build、forge_test、forge_create、forge_verify
• Cast 操作：cast_call、cast_send、cast_balance、cast_nonce、cast_gas_price
• Anvil 测试：anvil_start、anvil_snapshot、anvil_revert
• ZetaChain 高级功能：validator_create、governance_vote、staking_delegate、staking_rewards
• 跨链：cross_chain_send、cross_chain_status、bridge_status
• 智能合约：contract_compile、contract_deploy、contract_interact
• DeFi 操作：defi_swap、defi_liquidity_add、defi_yield_farm
• NFT 操作：nft_mint、nft_transfer、nft_metadata
• 钱包管理：wallet_export、wallet_backup、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
• ✅ Foundry 工具包（forge、cast、anvil）
• ✅ 全部 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 云端（托管）

Claude Code 命令行：

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
• 搜索："universal-blockchain-mcp"
• 提供一键安装

PulseMCP 目录：

• 访问：https://pulsemcp.com
• 浏览：区块链与 Web3 类别
• 可直接集成 Cursor、Claude 和 Cline

Glama 注册表：

• 访问：https://glama.ai
• 搜索："ZetaChain" 或 "blockchain"
• 集成多工具生态系统

Fleur（Mac + Claude）：

• 访问：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 CLI（自动安装）
• 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?

支持的链

ZetaChain MCP 服务支持所有与 ZetaChain 连接的链：

• Ethereum（Sepolia 测试网）
• BSC（测试网）
• Polygon（Amoy 测试网）
• Avalanche（Fuji 测试网）
• Arbitrum（Sepolia）
• Base（Sepolia）
• Bitcoin（测试网/Signet）
• Solana（Devnet）
• TON（测试网）
• Sui（测试网）
• Kaia（测试网）

要求

• Node.js 18+
• ZetaChain CLI（作为依赖自动安装）
• Foundry（用于智能合约开发，自动安装）

架构

此 MCP 服务在 AI 助手与 ZetaChain CLI 之间提供桥接，使以下功能成为可能：

• 直接集成 CLI：所有命令均通过官方 ZetaChain CLI 执行
• 实时数据：来自 ZetaChain 网络的实时区块链数据
• 跨链功能：全面使用 ZetaChain 的全链能力
• 开发工具：项目创建、账户管理和测试实用工具

许可证

MIT