de en es ja ko ru zh

Zetrix MCP Server

Name: Zetrix MCP Server
Author: Zetrix-Chain

Official

by Zetrix-Chain

Overview Schema Related Servers Score Discussions

JavaScript

Remote

Zetrix MCP 服务器

一个用于与 Zetrix 区块链交互的综合模型上下文协议 (MCP) 服务器。提供跨 7 个类别的 55 个工具 — HTTP RPC、WebSocket (protobuf)、SDK 交易、密码学和智能合约开发。支持 stdio 和 HTTP 传输模式。

Zetrix 货币信息

原生代币： ZETRIX

主单位： ZETRIX
基础单位： ZETA
换算： 1 ZETRIX = 1,000,000 ZETA
Gas 价格： 通过 testTransaction 动态评估

快速入门

npx zetrix-mcp-server

或全局安装：

npm install -g zetrix-mcp-server

指南：

QUICKSTART.md — 5 分钟内完成设置
EXAMPLES.md — 通过 20 多个示例学习
TEST_REPORT.md — 所有 55 个工具的综合测试报告

功能 (56 个工具)

常规 (1 个工具)

工具	描述
`zetrix_version`	获取 MCP 服务器版本和网络信息

HTTP RPC (16 个工具)

工具	描述
`zetrix_check_health`	检查节点健康状态
`zetrix_get_account`	获取账户信息，包括余额和元数据
`zetrix_get_block`	按高度获取区块
`zetrix_get_latest_block`	获取最新区块
`zetrix_get_transaction`	按哈希获取交易
`zetrix_get_balance`	获取 ZETA 和 ZETRIX 余额
`zetrix_create_keypair`	生成新密钥对（仅限测试）
`zetrix_get_account_base`	获取基本账户信息
`zetrix_get_account_assets`	获取资产持有情况
`zetrix_get_account_metadata`	获取账户元数据
`zetrix_get_transaction_history`	获取已完成的交易
`zetrix_get_transaction_cache`	获取待处理交易
`zetrix_get_ledger`	获取账本/区块信息
`zetrix_multi_query`	执行多个查询
`zetrix_get_transaction_blob`	将交易序列化为十六进制
`zetrix_submit_transaction`	提交已签名的交易

合约查询 (2 个工具)

工具	描述
`zetrix_call_contract`	在沙盒中调用合约（只读）
`zetrix_test_transaction`	评估费用而不提交

WebSocket — 实时 (5 个工具)

使用 protobuf 二进制编码 与 Zetrix 节点通信。

工具	描述
`zetrix_ws_connect`	通过 protobuf CHAIN_HELLO 连接并注册
`zetrix_ws_submit_transaction`	提交带有实时状态的交易
`zetrix_ws_subscribe_tx`	订阅交易通知
`zetrix_ws_disconnect`	断开 WebSocket 连接
`zetrix_ws_status`	检查连接状态

SDK 查询 (5 个工具)

工具	描述
`zetrix_sdk_create_account`	创建新账户
`zetrix_sdk_get_balance`	通过 SDK 获取余额
`zetrix_sdk_is_activated`	检查账户是否已激活
`zetrix_sdk_get_nonce`	获取账户 nonce
`zetrix_sdk_call_contract`	通过 SDK 调用合约（只读）

SDK 交易 (11 个工具)

所有交易工具都使用 evaluateFee (testTransaction) 进行动态 Gas 定价。所有操作均支持可选的 gasPrice/feeLimit 覆盖。

工具	描述
`zetrix_sdk_send_gas`	向另一个地址发送原生 ZETRIX
`zetrix_sdk_activate_account`	使用初始余额激活新账户
`zetrix_sdk_set_metadata`	在账户上设置键值元数据
`zetrix_sdk_set_privilege`	设置账户权重、阈值和签名者
`zetrix_sdk_issue_asset`	发行新的自定义代币
`zetrix_sdk_send_asset`	转移自定义代币
`zetrix_sdk_create_contract`	部署智能合约（可选所有者）
`zetrix_sdk_invoke_contract`	使用 Gas 支付调用合约
`zetrix_sdk_invoke_contract_by_asset`	通过资产转移调用合约
`zetrix_sdk_upgrade_contract`	升级合约代码和/或转移所有权
`zetrix_sdk_create_log`	创建链上事件日志

密码学 (8 个工具)

工具	描述
`zetrix_crypto_generate_keypair`	生成新密钥对（地址、私钥、公钥）
`zetrix_crypto_get_public_key`	从私钥导出公钥
`zetrix_crypto_get_address`	从公钥获取地址
`zetrix_crypto_validate_key`	验证私钥、公钥或地址格式
`zetrix_crypto_sign`	使用私钥对消息（十六进制）进行签名
`zetrix_crypto_verify`	验证签名
`zetrix_crypto_encrypt_key`	使用密码加密私钥
`zetrix_crypto_decrypt_key`	解密已加密的私钥

智能合约开发 (7 个工具)

工具	描述
`zetrix_contract_get_chain_functions`	Chain 对象函数文档
`zetrix_contract_get_utils_functions`	Utils 对象函数文档
`zetrix_contract_get_structure_guide`	合约结构和 ES5 模式指南
`zetrix_contract_get_token_standard`	代币标准规范 (ZTP20, ZTP721, ZTP1155)
`zetrix_contract_init_dev_environment`	通过 `create-zetrix-tool` 初始化开发项目
`zetrix_contract_generate_advanced`	生成多类合约架构
`zetrix_contract_get_testing_guide`	测试指南 (TEST_INVOKE, TEST_QUERY)

支持的网络

网络	HTTP RPC	WebSocket
主网	`https://node.zetrix.com`	`wss://ws-node.zetrix.com`
测试网	`https://test-node.zetrix.com`	`wss://test-ws-node.zetrix.com`

配置

环境变量

变量	描述	默认值
`ZETRIX_NETWORK`	网络选择 (`mainnet` 或 `testnet`)	`mainnet`
`ZETRIX_RPC_URL`	自定义 HTTP RPC 端点（覆盖网络默认值）	—
`ZETRIX_WS_URL`	自定义 WebSocket 端点（覆盖网络默认值）	—
`ZETRIX_TRANSPORT`	传输模式 (`stdio` 或 `http`)	`stdio`
`ZETRIX_PORT`	HTTP 服务器端口（仅在 `ZETRIX_TRANSPORT=http` 时使用）	`3000`
`ZETRIX_PRIVATE_KEY`	用于签署交易的默认私钥（可选，防止密钥泄露到对话中）	—
`ZETRIX_SOURCE_ADDRESS`	交易的默认源地址（可选）	—

安全交易（推荐）

通过将 ZETRIX_PRIVATE_KEY 和 ZETRIX_SOURCE_ADDRESS 设置为环境变量，您的私钥永远不会暴露在对话中。LLM 可以执行诸如“发送 0.01 ZETRIX 到 ZTX3...”之类的交易，而无需查看您的密钥。

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

注意： 这些是可选的。如果未设置，LLM 将需要在对话中询问或被告知私钥和源地址。如果已设置，它们将用作默认值 — 您仍然可以在需要时在每次工具调用中覆盖它们。

Claude Code (CLI)

直接从命令行添加 MCP 服务器：

主网：

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

测试网：

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

使用自定义 RPC 和 WebSocket URL：

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

编辑您的 Claude Desktop 配置文件：

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

测试网：

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

主网：

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

两个网络（主网 + 测试网）：

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

使用自定义 RPC 和 WebSocket URL：

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

保存配置文件后，重启 Claude Desktop 以使更改生效。

注意： ZETRIX_RPC_URL 和 ZETRIX_WS_URL 会覆盖所选网络的默认端点。您可以仅覆盖其中一个或两个。如果未设置，则使用上表中的默认值。

HTTP 传输 (API 服务器)

使用 Streamable HTTP 传输将 MCP 服务器作为 HTTP API 服务器运行。这允许远程 MCP 客户端通过网络连接。

启动服务器（默认为主网）：

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

使用测试网：

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

端点：

端点	方法	描述
`/mcp`	POST	MCP 协议端点 (Streamable HTTP)
`/health`	GET	健康检查 — 返回 `{ status, version, network }`

从 MCP 客户端连接：

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

两个网络（主网 + 测试网）：

在不同端口上运行两个服务器：

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 &

然后配置您的 MCP 客户端：

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

注意： HTTP 传输使用 MCP Streamable HTTP 规范。任何支持 StreamableHTTP 传输的 MCP 客户端都可以连接到它。

服务器日志：

服务器将日志记录到 stderr。要查看日志，请在前台运行或重定向到文件：

# 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

开发

项目结构

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

构建

npm install
npm run build

测试

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

许可证

MIT

Install Server

security – no known vulnerabilities

license - permissive license

quality - not tested

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

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