wax-mcp-full

v0.1.0 — ein lokaler MCP-Server für die WAX-Blockchain.

Er ermöglicht es einem KI-Host (Claude Desktop, Cursor, Grok Build, …), Konten, Chain-Status, AtomicAssets / AtomicMarket, Hyperion-Verlauf und WAXP-Preise abzufragen und nicht signierte Transaktionen für eine Wallet zur Signierung vorzubereiten. Keine API-Schlüssel. Mainnet und Testnet.

Dies ist eine frühe öffentliche Veröffentlichung. Sie ist vollständiger als das archivierte yksanjo/wax-mcp-server (8 Tools, einzelner RPC, tote v1-Historie). Es ist kein 1.0.

Funktionen

Registriert auch Ressourcen (wax://account/{name}, …) und Prompts (inspect-account, market-overview, …).

Voraussetzungen

• Node.js 20+

• HTTPS-Zugriff auf öffentliche WAX-Gilden-APIs (keine Schlüssel)

Installation

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

Entwicklung (ohne Build):

npx tsx src/index.ts --network mainnet

Zu einem Host hinzufügen

Ersetze /ABSOLUTE/PATH/TO/wax-mcp-full durch den Ordner, den du geklont hast.

Claude Desktop

claude_desktop_config.json:

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

Starte Claude Desktop neu.

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

Oder: grok mcp add wax -- node /ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js

Kopier- und Einfügevorlagen befinden sich in examples/.

Konfiguration

CLI: --network mainnet\|testnet.

Nur https-URLs werden akzeptiert. Tools akzeptieren niemals ein RPC-URL-Argument.

eosjs ist standardmäßig nicht installiert. Bevorzuge eine Wallet. Lokales wax_sign_broadcast erfordert npm install eosjs plus WAX_ENABLE_SIGNING=1.

Sicherheit

• Vorbereitungstools geben nicht signiertes JSON zurück. Signiere in Anchor, WAX Cloud Wallet oder cleos.

• wax_simulate_transaction sendet niemals. Öffentliche RPCs können oft nicht signiertes JSON nicht trocken testen; dann ist simulated false.

• Gib niemals einen privaten Schlüssel in den Chat oder als Tool-Argument ein.

Beispiel-Prompts

• „Wie hoch ist der WAXP-Preis und das 24h-Volumen?“

• „Zeige CPU/NET/RAM und Token für eosio.“

• „Liste aktuelle AtomicMarket-Verkäufe für alien.worlds auf.“

• „Bereite eine nicht signierte Überweisung von 1.00000000 WAX von alice an bob vor — signiere sie nicht.“

Mehr in examples/example-prompts.md.

Tests

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

Bekannte Grenzen (v0.1)

• Öffentliche Atomic-/Hyperion-Knoten können langsam sein oder Ratenbegrenzungen haben.

• Simulieren ist nach bestem Bemühen; viele RPCs lehnen nicht signiertes JSON ab.

• MCP-Ressourcen haben kein isError-Flag — Fehler sind JSON innerhalb eines erfolgreichen Lesevorgangs.

• wax_get_block gibt Header + transaction_count zurück, nicht vollständige Transaktionen.

• Optionale lokale Signierung ist eine Gefahr. Lass sie deaktiviert.

Lizenz

MIT