Zetrix MCP Server

Zetrix MCP服务器

用于与Zetrix区块链交互的综合模型上下文协议（MCP）服务器。提供 55工具 跨7个类别——HTTP RPC、WebSocket（protobuf）、SDK事务、密码学和智能合约开发。支持两者 标准 和 超文本传输协议 运输方式。

Zetrix货币信息

本地硬币： ZETRIX

• 主要单位： ZETRIX
• 基本单位： 泽塔
• 转换： 1 ZETRIX=1000000 ZETA
• 天然气价格： 通过以下方式动态评估 testTransaction

快速开始

npx zetrix-mcp-server

或全局安装：

npm install -g zetrix-mcp-server

指南：

• QUICKSTART.md --5分钟内完成设置
• 示例.md --通过20+个示例学习
• 测试报告.md --所有55个工具的综合测试结果

功能（56工具）

通用（1个工具）

HTTP RPC（16个工具）

合同查询（2个工具）

WebSocket——实时（5个工具）

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

SDK查询（5个工具）

SDK交易（11个工具）

所有交易工具使用 evaluateFee （testTransaction）用于动态天然气定价。可选的 gasPrice/feeLimit 所有操作都支持覆盖。

密码学（8个工具）

智能合约开发（7个工具）

支持的网络

配置

环境变量

安全交易（推荐）

通过设置 ZETRIX_PRIVATE_KEY 和 ZETRIX_SOURCE_ADDRESS 作为环境变量，您的私钥永远不会在对话中公开。LLM可以执行诸如“向ZTX3发送0.01 ZETRIX…”之类的事务，而无需看到您的密钥。

{
  "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将需要在对话中请求或获得私钥和源地址。如果设置了，它们将用作默认值——如果需要，您仍然可以在每次工具调用时覆盖它们。

克劳德代码（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配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Windows（微软应用商店）： %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服务器）

使用流式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客户端连接：

{
  "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规范。任何支持以下功能的MCP客户端 StreamableHTTP 交通工具可以连接到它。

服务器日志：

服务器记录到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

许可证

麻省理工学院