Skip to main content
Glama
Zetrix-Chain

Zetrix MCP Server

Official
by Zetrix-Chain

Zetrix MCP-Server

Ein umfassender Model Context Protocol (MCP)-Server für die Interaktion mit der Zetrix-Blockchain. Bietet 55 Tools in 7 Kategorien — HTTP RPC, WebSocket (Protobuf), SDK-Transaktionen, Kryptografie und Smart-Contract-Entwicklung. Unterstützt sowohl stdio- als auch HTTP-Transportmodi.

Zetrix Währungsinformationen

Native Coin: ZETRIX

  • Haupteinheit: ZETRIX

  • Basiseinheit: ZETA

  • Umrechnung: 1 ZETRIX = 1.000.000 ZETA

  • Gas-Preis: Dynamisch bewertet über testTransaction

Schnellstart

npx zetrix-mcp-server

Oder global installieren:

npm install -g zetrix-mcp-server

Anleitungen:

Funktionen (56 Tools)

Allgemein (1 Tool)

Tool

Beschreibung

zetrix_version

MCP-Serverversion und Netzwerkinformationen abrufen

HTTP RPC (16 Tools)

Tool

Beschreibung

zetrix_check_health

Knoten-Gesundheitsstatus prüfen

zetrix_get_account

Kontoinformationen inklusive Guthaben und Metadaten abrufen

zetrix_get_block

Block nach Höhe abrufen

zetrix_get_latest_block

Neuesten Block abrufen

zetrix_get_transaction

Transaktion nach Hash abrufen

zetrix_get_balance

Guthaben in ZETA und ZETRIX abrufen

zetrix_create_keypair

Neues Schlüsselpaar generieren (nur zum Testen)

zetrix_get_account_base

Grundlegende Kontoinformationen abrufen

zetrix_get_account_assets

Vermögenswerte abrufen

zetrix_get_account_metadata

Kontometadaten abrufen

zetrix_get_transaction_history

Abgeschlossene Transaktionen abrufen

zetrix_get_transaction_cache

Ausstehende Transaktionen abrufen

zetrix_get_ledger

Ledger-/Blockinformationen abrufen

zetrix_multi_query

Mehrere Abfragen ausführen

zetrix_get_transaction_blob

Transaktion in Hex serialisieren

zetrix_submit_transaction

Signierte Transaktion einreichen

Vertragsabfrage (2 Tools)

Tool

Beschreibung

zetrix_call_contract

Vertrag in Sandbox aufrufen (nur lesen)

zetrix_test_transaction

Gebühren bewerten, ohne einzureichen

WebSocket — Echtzeit (5 Tools)

Verwendet Protobuf-Binärkodierung für die Kommunikation mit Zetrix-Knoten.

Tool

Beschreibung

zetrix_ws_connect

Verbinden und registrieren via Protobuf CHAIN_HELLO

zetrix_ws_submit_transaction

Transaktion mit Echtzeitstatus einreichen

zetrix_ws_subscribe_tx

Transaktionsbenachrichtigungen abonnieren

zetrix_ws_disconnect

Von WebSocket trennen

zetrix_ws_status

Verbindungsstatus prüfen

SDK-Abfrage (5 Tools)

Tool

Beschreibung

zetrix_sdk_create_account

Neues Konto erstellen

zetrix_sdk_get_balance

Guthaben via SDK abrufen

zetrix_sdk_is_activated

Prüfen, ob Konto aktiviert ist

zetrix_sdk_get_nonce

Kontononce abrufen

zetrix_sdk_call_contract

Vertrag via SDK aufrufen (nur lesen)

SDK-Transaktionen (11 Tools)

Alle Transaktionstools verwenden evaluateFee (testTransaction) für dynamische Gas-Preise. Optionale gasPrice/feeLimit-Überschreibungen werden bei allen Vorgängen unterstützt.

Tool

Beschreibung

zetrix_sdk_send_gas

Natives ZETRIX an eine andere Adresse senden

zetrix_sdk_activate_account

Neues Konto mit Anfangsguthaben aktivieren

zetrix_sdk_set_metadata

Schlüssel-Wert-Metadaten für ein Konto festlegen

zetrix_sdk_set_privilege

Kontogewichtungen, Schwellenwerte und Unterzeichner festlegen

zetrix_sdk_issue_asset

Neuen benutzerdefinierten Token ausgeben

zetrix_sdk_send_asset

Benutzerdefinierten Token übertragen

zetrix_sdk_create_contract

Smart Contract bereitstellen (mit optionalem Eigentümer)

zetrix_sdk_invoke_contract

Vertrag mit Gas-Zahlung aufrufen

zetrix_sdk_invoke_contract_by_asset

Vertrag mit Token-Übertragung aufrufen

zetrix_sdk_upgrade_contract

Vertragscode aktualisieren und/oder Eigentümerschaft übertragen

zetrix_sdk_create_log

On-Chain-Ereignisprotokoll erstellen

Kryptografie (8 Tools)

Tool

Beschreibung

zetrix_crypto_generate_keypair

Neues Schlüsselpaar generieren (Adresse, privater Schlüssel, öffentlicher Schlüssel)

zetrix_crypto_get_public_key

Öffentlichen Schlüssel aus privatem Schlüssel ableiten

zetrix_crypto_get_address

Adresse aus öffentlichem Schlüssel abrufen

zetrix_crypto_validate_key

Format von privatem Schlüssel, öffentlichem Schlüssel oder Adresse validieren

zetrix_crypto_sign

Nachricht (Hex) mit privatem Schlüssel signieren

zetrix_crypto_verify

Signatur verifizieren

zetrix_crypto_encrypt_key

Privaten Schlüssel mit Passwort verschlüsseln

zetrix_crypto_decrypt_key

Verschlüsselten privaten Schlüssel entschlüsseln

Smart-Contract-Entwicklung (7 Tools)

Tool

Beschreibung

zetrix_contract_get_chain_functions

Dokumentation der Chain-Objektfunktionen

zetrix_contract_get_utils_functions

Dokumentation der Utils-Objektfunktionen

zetrix_contract_get_structure_guide

Leitfaden für Vertragsstruktur und ES5-Muster

zetrix_contract_get_token_standard

Token-Standard-Spezifikationen (ZTP20, ZTP721, ZTP1155)

zetrix_contract_init_dev_environment

Entwicklungsprojekt via create-zetrix-tool initialisieren

zetrix_contract_generate_advanced

Multi-Class-Vertragsarchitektur generieren

zetrix_contract_get_testing_guide

Testleitfaden (TEST_INVOKE, TEST_QUERY)

Unterstützte Netzwerke

Netzwerk

HTTP RPC

WebSocket

Mainnet

https://node.zetrix.com

wss://ws-node.zetrix.com

Testnet

https://test-node.zetrix.com

wss://test-ws-node.zetrix.com

Konfiguration

Umgebungsvariablen

Variable

Beschreibung

Standard

ZETRIX_NETWORK

Netzwerkauswahl (mainnet oder testnet)

mainnet

ZETRIX_RPC_URL

Benutzerdefinierter HTTP RPC-Endpunkt (überschreibt Netzwerkstandard)

ZETRIX_WS_URL

Benutzerdefinierter WebSocket-Endpunkt (überschreibt Netzwerkstandard)

ZETRIX_TRANSPORT

Transportmodus (stdio oder http)

stdio

ZETRIX_PORT

HTTP-Server-Port (nur verwendet, wenn ZETRIX_TRANSPORT=http)

3000

ZETRIX_PRIVATE_KEY

Standard-Privatschlüssel zum Signieren von Transaktionen (optional, hält Schlüssel aus der Konversation fern)

ZETRIX_SOURCE_ADDRESS

Standard-Quelladresse für Transaktionen (optional)

Sichere Transaktionen (Empfohlen)

Durch das Festlegen von ZETRIX_PRIVATE_KEY und ZETRIX_SOURCE_ADDRESS als Umgebungsvariablen wird Ihr privater Schlüssel niemals in der Konversation offengelegt. Die LLM kann Transaktionen wie "Sende 0,01 ZETRIX an ZTX3..." ausführen, ohne jemals Ihren Schlüssel zu sehen.

{
  "mcpServers": {
    "zetrix": {
      "command": "npx",
      "args": ["-y", "zetrix-mcp-server"],
      "env": {
        "ZETRIX_NETWORK": "testnet",
        "ZETRIX_PRIVATE_KEY": "your-private-key-here",
        "ZETRIX_SOURCE_ADDRESS": "your-zetrix-address-here"
      }
    }
  }
}

Hinweis: Diese sind optional. Falls nicht festgelegt, muss die LLM nach dem privaten Schlüssel und der Quelladresse fragen oder diese in der Konversation erhalten. Falls festgelegt, werden sie als Standardwerte verwendet — Sie können sie bei Bedarf pro Tool-Aufruf überschreiben.

Claude Code (CLI)

Fügen Sie den MCP-Server direkt über die Befehlszeile hinzu:

Mainnet:

claude mcp add zetrix-mainnet -s user -- npx -y zetrix-mcp-server -e ZETRIX_NETWORK=mainnet

Testnet:

claude mcp add zetrix-testnet -s user -- npx -y zetrix-mcp-server -e ZETRIX_NETWORK=testnet

Mit benutzerdefinierten RPC- und WebSocket-URLs:

claude mcp add zetrix-testnet -s user -- npx -y zetrix-mcp-server \
  -e ZETRIX_NETWORK=testnet \
  -e ZETRIX_RPC_URL=https://your-node.example.com \
  -e ZETRIX_WS_URL=wss://your-ws-node.example.com

Claude Desktop

Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Windows (Microsoft Store): %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

Testnet:

{
  "mcpServers": {
    "zetrix": {
      "command": "npx",
      "args": ["-y", "zetrix-mcp-server"],
      "env": {
        "ZETRIX_NETWORK": "testnet"
      }
    }
  }
}

Mainnet:

{
  "mcpServers": {
    "zetrix": {
      "command": "npx",
      "args": ["-y", "zetrix-mcp-server"],
      "env": {
        "ZETRIX_NETWORK": "mainnet"
      }
    }
  }
}

Beide Netzwerke (Mainnet + Testnet):

{
  "mcpServers": {
    "zetrix-mainnet": {
      "command": "npx",
      "args": ["-y", "zetrix-mcp-server"],
      "env": {
        "ZETRIX_NETWORK": "mainnet"
      }
    },
    "zetrix-testnet": {
      "command": "npx",
      "args": ["-y", "zetrix-mcp-server"],
      "env": {
        "ZETRIX_NETWORK": "testnet"
      }
    }
  }
}

Mit benutzerdefinierten RPC- und WebSocket-URLs:

{
  "mcpServers": {
    "zetrix": {
      "command": "npx",
      "args": ["-y", "zetrix-mcp-server"],
      "env": {
        "ZETRIX_NETWORK": "testnet",
        "ZETRIX_RPC_URL": "https://your-node.example.com",
        "ZETRIX_WS_URL": "wss://your-ws-node.example.com"
      }
    }
  }
}

Starten Sie nach dem Speichern der Konfigurationsdatei Claude Desktop neu, damit die Änderungen wirksam werden.

Hinweis: ZETRIX_RPC_URL und ZETRIX_WS_URL überschreiben die Standard-Endpunkte für das ausgewählte Netzwerk. Sie können nur einen oder beide überschreiben. Falls nicht festgelegt, werden die Standardwerte aus der obigen Tabelle verwendet.

HTTP-Transport (API-Server)

Führen Sie den MCP-Server als HTTP-API-Server unter Verwendung des Streamable HTTP-Transports aus. Dies ermöglicht es entfernten MCP-Clients, sich über das Netzwerk zu verbinden.

Server starten (Standard ist Mainnet):

ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 npx zetrix-mcp-server

Mit Testnet:

ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 ZETRIX_NETWORK=testnet npx zetrix-mcp-server

Endpunkte:

Endpunkt

Methode

Beschreibung

/mcp

POST

MCP-Protokoll-Endpunkt (Streamable HTTP)

/health

GET

Gesundheitsprüfung — gibt { status, version, network } zurück

Verbindung von einem MCP-Client:

{
  "mcpServers": {
    "zetrix": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Beide Netzwerke (Mainnet + Testnet):

Führen Sie zwei Server auf verschiedenen Ports aus:

ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 ZETRIX_NETWORK=mainnet npx zetrix-mcp-server &
ZETRIX_TRANSPORT=http ZETRIX_PORT=3001 ZETRIX_NETWORK=testnet npx zetrix-mcp-server &

Konfigurieren Sie dann Ihren MCP-Client:

{
  "mcpServers": {
    "zetrix-mainnet": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    },
    "zetrix-testnet": {
      "type": "http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

Hinweis: Der HTTP-Transport verwendet die MCP Streamable HTTP-Spezifikation. Jeder MCP-Client, der den StreamableHTTP-Transport unterstützt, kann sich damit verbinden.

Server-Logs:

Der Server protokolliert nach stderr. Um Logs anzuzeigen, führen Sie ihn im Vordergrund aus oder leiten Sie sie in eine Datei um:

# Foreground — logs show directly in terminal
ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 npx zetrix-mcp-server

# Background with logs to file
ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 npx zetrix-mcp-server 2> server.log &
tail -f server.log

Entwicklung

Projektstruktur

zetrix-mcp-server/
├── src/
│   ├── index.ts                  # MCP server (55 tool definitions + handlers)
│   ├── zetrix-client.ts          # HTTP RPC client
│   ├── zetrix-sdk.ts             # SDK wrapper (11 transaction operations)
│   ├── zetrix-websocket.ts       # WebSocket client (protobuf binary)
│   ├── zetrix-encryption.ts      # Crypto operations
│   ├── zetrix-contract-docs.ts   # Contract documentation
│   └── zetrix-contract-generator.ts # Contract code generator
├── tests/
│   ├── test-server.js            # HTTP RPC tests
│   ├── test-sdk.js               # SDK tests
│   └── test-encryption.js        # Crypto tests
├── docs/
│   ├── TEST_REPORT.md            # Comprehensive test results
│   ├── DEVELOPER_GUIDE.md        # Developer documentation
│   ├── ZETRIX_CONTRACT_DEVELOPMENT_RULES.md
│   ├── QUICKSTART.md             # 5-minute setup guide
│   └── EXAMPLES.md               # 20+ usage examples
└── dist/                         # Compiled output

Build

npm install
npm run build

Test

npm test                           # HTTP RPC tests
ZETRIX_NETWORK=testnet npm test    # Run on testnet
npm run test:sdk                   # SDK tests
npm run test:encryption            # Crypto tests

Lizenz

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Zetrix-Chain/zetrix-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server