z2-trade-trust-mcp

MCP (Model Context Protocol)-Server, der TradeTrust-Dokument-/eBL-Operationen auf dem Zetrix L2 als MCP-Tools bereitstellt – ein schlanker, HMAC-signierter Client über die REST-API von core-engine. Lesewerkzeuge (verifizieren, Status, Finalitätsabfragen) funktionieren nur mit einer baseUrl; Schreib-/Workflow-Werkzeuge (ausstellen, minten, übertragen, signieren) sind optional und benötigen eine Aufruferidentität.

Installieren

npm install

Ebenfalls auf npm veröffentlicht als zetrix-tradetrust-mcp.

Related MCP server: tracepass-mcp-server

Konfigurieren

export Z2TT_ENV="z2-testnet"       # or "z2-mainnet" -- shortcut for the known core-engine deployments
# export Z2TT_BASE_URL="https://core-engine.example/api/z2-core-engine"  # custom deployment instead
export Z2TT_CALLER_ID="z2-trade-trust-mcp"
export Z2TT_HMAC_SECRET="…"        # issued out-of-band by whoever operates the deployment
export Z2TT_ALLOW_WRITES="true"    # omit/false to register read-only tools

Oder verweise Z2TT_PROFILE stattdessen auf eine JSON-Datei:

{
  "baseUrl": "https://core-engine.example/api/z2-core-engine",
  "callerId": "z2-trade-trust-mcp",
  "hmacSecret": "…"
}

Ausführen

npm run build
node dist/index.js

Oder direkt aus dem Quellcode mit npm run dev ausführen (kein Build-Schritt). In beiden Fällen lauscht der Prozess auf stdio – er gibt bei Erfolg nichts aus, da MCP-Clients ihn starten und das Protokoll über stdin/stdout sprechen, nicht über eine menschliche Terminalsitzung.

Bei einem MCP-Client registrieren

{
  "mcpServers": {
    "z2-trade-trust-mcp": {
      "command": "node",
      "args": ["/abs/path/dist/index.js"],
      "env": {
        "Z2TT_BASE_URL": "https://core-engine.example/api/z2-core-engine",
        "Z2TT_CALLER_ID": "z2-trade-trust-mcp",
        "Z2TT_HMAC_SECRET": "…",
        "Z2TT_ALLOW_WRITES": "false"
      }
    }
  }
}

OpenClaw

Wenn der Client OpenClaw ist, überspringe die manuelle mcpServers-Verdrahtung und installiere stattdessen openclaw-plugin/ — openclaw plugins install ./openclaw-plugin registriert diesen Server selbst und stellt die gleiche Konfiguration als Plugin-Einstellungen bereit (network/baseUrl/callerId/hmacSecret/allowWrites).

Lizenz

MIT – siehe LICENSE.