wax-mcp-full

v0.1.0 — 一个面向 WAX 区块链的本地优先 MCP 服务器。

它允许 AI 主机（Claude Desktop、Cursor、Grok Build 等）查询账户、链状态、AtomicAssets / AtomicMarket、Hyperion 历史记录和 WAXP 价格，并准备未签名交易供钱包签名。无需 API 密钥。支持主网和测试网。

这是早期公开版本。它比已归档的 yksanjo/wax-mcp-server（8 个工具、单 RPC、已失效的 v1 历史）更完整。并非 1.0 版本。

功能

同时注册了资源（wax://account/{name} 等）和提示（inspect-account、market-overview 等）。

要求

• Node.js 20+

• 可通过 HTTPS 访问公共 WAX 公会 API（无需密钥）

安装

git clone https://github.com/eoinjosephcurran-code/wax-mcp-full.git
cd wax-mcp-full
npm install
npm run build
node dist/index.js --help

开发模式（无需构建）：

npx tsx src/index.ts --network mainnet

添加到主机

将 /ABSOLUTE/PATH/TO/wax-mcp-full 替换为你克隆的文件夹。

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "wax": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"],
      "env": { "WAX_NETWORK": "mainnet" }
    }
  }
}

重启 Claude Desktop。

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "wax": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"]
    }
  }
}

Grok Build

~/.grok/config.toml：

[mcp_servers.wax]
command = "node"
args = ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"]
startup_timeout_sec = 30

或者：grok mcp add wax -- node /ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js

复制粘贴模板位于 examples/ 目录下。

配置

CLI：--network mainnet|testnet。

仅接受 https URL。工具从不接受 RPC URL 参数。

默认不安装 eosjs。建议使用钱包。本地 wax_sign_broadcast 需要 npm install eosjs 并设置 WAX_ENABLE_SIGNING=1。

安全

• 准备工具返回未签名 JSON。请在 Anchor、WAX Cloud Wallet 或 cleos 中签名。

• wax_simulate_transaction 从不广播。公共 RPC 通常无法对未签名 JSON 进行模拟；此时 simulated 为 false。

• 切勿将私钥放入聊天或工具参数中。

示例提示

• “WAXP 价格和 24 小时交易量是多少？”

• “显示 eosio 的 CPU/NET/RAM 和代币。”

• “列出 alien.worlds 最近的 AtomicMarket 销售。”

• “准备一笔从 alice 到 bob 的未签名转账 1.00000000 WAX — 不要签名。”

更多示例见 examples/example-prompts.md。

测试

npm test           # unit + MCP smoke + live probes (skip-soft if offline)
npm run test:live  # live probes; fail if public APIs are down
npm run typecheck

已知限制（v0.1）

• 公共 Atomic / Hyperion 节点可能较慢或存在速率限制。

• 模拟功能尽力而为；许多 RPC 拒绝未签名 JSON。

• MCP 资源没有 isError 标志 — 失败信息以 JSON 形式包含在成功读取中。

• wax_get_block 返回头部 + transaction_count，而非完整交易。

• 可选的本地签名存在风险。请保持关闭。

许可证

MIT