z2-trade-trust-mcp

Servidor MCP (Model Context Protocol) que expone operaciones de documentos/eBL de TradeTrust en la Zetrix L2 como herramientas MCP — un cliente ligero firmado con HMAC sobre la API REST de core-engine. Las herramientas de lectura (verificar, estado, consultas de finalidad) funcionan solo con una baseUrl; las herramientas de escritura/flujo de trabajo (emitir, acuñar, transferir, firmar) son opcionales y requieren una identidad de llamante.

Install

npm install

También publicado en npm como zetrix-tradetrust-mcp.

Related MCP server: tracepass-mcp-server

Configure

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

O apunta Z2TT_PROFILE a un archivo JSON en su lugar:

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

Run

npm run build
node dist/index.js

O ejecuta directamente desde el código fuente con npm run dev (sin paso de compilación). En cualquier caso, el proceso escucha en stdio — no imprime nada en caso de éxito, ya que los clientes MCP lo inician y hablan el protocolo a través de stdin/stdout, no de una sesión de terminal humana.

Register with an MCP client

{
  "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

Si el cliente es OpenClaw, omite la configuración manual de mcpServers e instala openclaw-plugin/ en su lugar — openclaw plugins install ./openclaw-plugin registra automáticamente este servidor y expone la misma configuración que los ajustes del plugin (network/baseUrl/callerId/hmacSecret/allowWrites).

License

MIT — consulta LICENSE.