z2-trade-trust-mcp

MCP (Model Context Protocol) сервер, предоставляющий операции с документами TradeTrust/eBL на Zetrix L2 в виде MCP инструментов — тонкий, HMAC-подписанный клиент REST API core-engine. Инструменты чтения (verify, status, finality lookups) работают только с baseUrl; инструменты записи/рабочего процесса (issue, mint, transfer, sign) являются дополнительными и требуют идентификатора вызывающего.

Установка

npm install

Также опубликован на npm как zetrix-tradetrust-mcp.

Related MCP server: tracepass-mcp-server

Конфигурация

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

Или укажите Z2TT_PROFILE на JSON файл вместо этого:

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

Запуск

npm run build
node dist/index.js

Или запустите напрямую из исходного кода с помощью npm run dev (без этапа сборки). В любом случае процесс прослушивает stdio — он ничего не выводит при успехе, так как MCP клиенты запускают его и общаются по протоколу через stdin/stdout, а не через человеческую терминальную сессию.

Регистрация в MCP клиенте

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

Если клиент — OpenClaw, пропустите ручную настройку mcpServers и установите openclaw-plugin/ вместо этого — openclaw plugins install ./openclaw-plugin саморегистрирует этот сервер и предоставляет ту же конфигурацию, что и настройки плагина (network/baseUrl/callerId/hmacSecret/allowWrites).

Лицензия

MIT — см. LICENSE.