Zetrix MCP Server
OfficialZetrix 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-serverOder global installieren:
npm install -g zetrix-mcp-serverAnleitungen:
QUICKSTART.md — Einrichtung in 5 Minuten
EXAMPLES.md — Lernen anhand von über 20 Beispielen
TEST_REPORT.md — Umfassende Testergebnisse für alle 55 Tools
Funktionen (56 Tools)
Allgemein (1 Tool)
Tool | Beschreibung |
| MCP-Serverversion und Netzwerkinformationen abrufen |
HTTP RPC (16 Tools)
Tool | Beschreibung |
| Knoten-Gesundheitsstatus prüfen |
| Kontoinformationen inklusive Guthaben und Metadaten abrufen |
| Block nach Höhe abrufen |
| Neuesten Block abrufen |
| Transaktion nach Hash abrufen |
| Guthaben in ZETA und ZETRIX abrufen |
| Neues Schlüsselpaar generieren (nur zum Testen) |
| Grundlegende Kontoinformationen abrufen |
| Vermögenswerte abrufen |
| Kontometadaten abrufen |
| Abgeschlossene Transaktionen abrufen |
| Ausstehende Transaktionen abrufen |
| Ledger-/Blockinformationen abrufen |
| Mehrere Abfragen ausführen |
| Transaktion in Hex serialisieren |
| Signierte Transaktion einreichen |
Vertragsabfrage (2 Tools)
Tool | Beschreibung |
| Vertrag in Sandbox aufrufen (nur lesen) |
| Gebühren bewerten, ohne einzureichen |
WebSocket — Echtzeit (5 Tools)
Verwendet Protobuf-Binärkodierung für die Kommunikation mit Zetrix-Knoten.
Tool | Beschreibung |
| Verbinden und registrieren via Protobuf CHAIN_HELLO |
| Transaktion mit Echtzeitstatus einreichen |
| Transaktionsbenachrichtigungen abonnieren |
| Von WebSocket trennen |
| Verbindungsstatus prüfen |
SDK-Abfrage (5 Tools)
Tool | Beschreibung |
| Neues Konto erstellen |
| Guthaben via SDK abrufen |
| Prüfen, ob Konto aktiviert ist |
| Kontononce abrufen |
| 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 |
| Natives ZETRIX an eine andere Adresse senden |
| Neues Konto mit Anfangsguthaben aktivieren |
| Schlüssel-Wert-Metadaten für ein Konto festlegen |
| Kontogewichtungen, Schwellenwerte und Unterzeichner festlegen |
| Neuen benutzerdefinierten Token ausgeben |
| Benutzerdefinierten Token übertragen |
| Smart Contract bereitstellen (mit optionalem Eigentümer) |
| Vertrag mit Gas-Zahlung aufrufen |
| Vertrag mit Token-Übertragung aufrufen |
| Vertragscode aktualisieren und/oder Eigentümerschaft übertragen |
| On-Chain-Ereignisprotokoll erstellen |
Kryptografie (8 Tools)
Tool | Beschreibung |
| Neues Schlüsselpaar generieren (Adresse, privater Schlüssel, öffentlicher Schlüssel) |
| Öffentlichen Schlüssel aus privatem Schlüssel ableiten |
| Adresse aus öffentlichem Schlüssel abrufen |
| Format von privatem Schlüssel, öffentlichem Schlüssel oder Adresse validieren |
| Nachricht (Hex) mit privatem Schlüssel signieren |
| Signatur verifizieren |
| Privaten Schlüssel mit Passwort verschlüsseln |
| Verschlüsselten privaten Schlüssel entschlüsseln |
Smart-Contract-Entwicklung (7 Tools)
Tool | Beschreibung |
| Dokumentation der Chain-Objektfunktionen |
| Dokumentation der Utils-Objektfunktionen |
| Leitfaden für Vertragsstruktur und ES5-Muster |
| Token-Standard-Spezifikationen (ZTP20, ZTP721, ZTP1155) |
| Entwicklungsprojekt via |
| Multi-Class-Vertragsarchitektur generieren |
| Testleitfaden (TEST_INVOKE, TEST_QUERY) |
Unterstützte Netzwerke
Netzwerk | HTTP RPC | WebSocket |
Mainnet |
|
|
Testnet |
|
|
Konfiguration
Umgebungsvariablen
Variable | Beschreibung | Standard |
| Netzwerkauswahl ( |
|
| Benutzerdefinierter HTTP RPC-Endpunkt (überschreibt Netzwerkstandard) | — |
| Benutzerdefinierter WebSocket-Endpunkt (überschreibt Netzwerkstandard) | — |
| Transportmodus ( |
|
| HTTP-Server-Port (nur verwendet, wenn |
|
| Standard-Privatschlüssel zum Signieren von Transaktionen (optional, hält Schlüssel aus der Konversation fern) | — |
| 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=mainnetTestnet:
claude mcp add zetrix-testnet -s user -- npx -y zetrix-mcp-server -e ZETRIX_NETWORK=testnetMit 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.comClaude Desktop
Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonWindows (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_URLundZETRIX_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-serverMit Testnet:
ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 ZETRIX_NETWORK=testnet npx zetrix-mcp-serverEndpunkte:
Endpunkt | Methode | Beschreibung |
| POST | MCP-Protokoll-Endpunkt (Streamable HTTP) |
| GET | Gesundheitsprüfung — gibt |
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.logEntwicklung
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 outputBuild
npm install
npm run buildTest
npm test # HTTP RPC tests
ZETRIX_NETWORK=testnet npm test # Run on testnet
npm run test:sdk # SDK tests
npm run test:encryption # Crypto testsLizenz
MIT
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