Zetrix MCP Server
OfficialZetrix MCPサーバー
Zetrixブロックチェーンと対話するための包括的なModel Context Protocol (MCP) サーバーです。HTTP RPC、WebSocket (protobuf)、SDKトランザクション、暗号化、スマートコントラクト開発という7つのカテゴリにわたる55個のツールを提供します。stdioおよびHTTPトランスポートモードの両方をサポートしています。
Zetrix通貨情報
ネイティブコイン: ZETRIX
メイン単位: ZETRIX
基本単位: ZETA
換算: 1 ZETRIX = 1,000,000 ZETA
ガス代:
testTransactionを通じて動的に評価
クイックスタート
npx zetrix-mcp-serverまたはグローバルにインストール:
npm install -g zetrix-mcp-serverガイド:
QUICKSTART.md — 5分でセットアップ
EXAMPLES.md — 20以上の例で学習
TEST_REPORT.md — 全55ツールの包括的なテスト結果
機能 (56ツール)
一般 (1ツール)
ツール | 説明 |
| MCPサーバーのバージョンとネットワーク情報を取得 |
HTTP RPC (16ツール)
ツール | 説明 |
| ノードの健全性ステータスを確認 |
| 残高やメタデータを含むアカウント情報を取得 |
| 高さからブロックを取得 |
| 最新のブロックを取得 |
| ハッシュからトランザクションを取得 |
| ZETAおよびZETRIXの残高を取得 |
| 新しいキーペアを生成 (テスト用) |
| 基本的なアカウント情報を取得 |
| 資産保有状況を取得 |
| アカウントメタデータを取得 |
| 完了したトランザクションを取得 |
| 保留中のトランザクションを取得 |
| 台帳/ブロック情報を取得 |
| 複数のクエリを実行 |
| トランザクションを16進数にシリアライズ |
| 署名済みトランザクションを送信 |
コントラクトクエリ (2ツール)
ツール | 説明 |
| サンドボックス内でコントラクトを呼び出し (読み取り専用) |
| 送信せずに手数料を評価 |
WebSocket — リアルタイム (5ツール)
Zetrixノードとの通信にはprotobufバイナリエンコーディングを使用します。
ツール | 説明 |
| protobuf CHAIN_HELLO経由で接続および登録 |
| リアルタイムステータス付きでトランザクションを送信 |
| トランザクション通知を購読 |
| WebSocketから切断 |
| 接続ステータスを確認 |
SDKクエリ (5ツール)
ツール | 説明 |
| 新しいアカウントを作成 |
| SDK経由で残高を取得 |
| アカウントが有効化されているか確認 |
| アカウントのナンスを取得 |
| SDK経由でコントラクトを呼び出し (読み取り専用) |
SDKトランザクション (11ツール)
すべてのトランザクションツールは、動的なガス価格設定のために evaluateFee (testTransaction) を使用します。すべての操作でオプションの gasPrice/feeLimit 上書きがサポートされています。
ツール | 説明 |
| ネイティブZETRIXを別のアドレスに送信 |
| 初期残高で新しいアカウントを有効化 |
| アカウントにキーと値のメタデータを設定 |
| アカウントの重み、しきい値、署名者を設定 |
| 新しいカスタムトークンを発行 |
| カスタムトークンを転送 |
| スマートコントラクトをデプロイ (オプションで所有者指定可) |
| ガス支払い付きでコントラクトを呼び出し |
| 資産転送付きでコントラクトを呼び出し |
| コントラクトコードのアップグレードおよび/または所有権の移転 |
| オンチェーンイベントログを作成 |
暗号化 (8ツール)
ツール | 説明 |
| 新しいキーペアを生成 (アドレス、秘密鍵、公開鍵) |
| 秘密鍵から公開鍵を導出 |
| 公開鍵からアドレスを取得 |
| 秘密鍵、公開鍵、またはアドレス形式を検証 |
| 秘密鍵でメッセージ (16進数) に署名 |
| 署名を検証 |
| パスワードで秘密鍵を暗号化 |
| 暗号化された秘密鍵を復号 |
スマートコントラクト開発 (7ツール)
ツール | 説明 |
| Chainオブジェクト関数のドキュメント |
| Utilsオブジェクト関数のドキュメント |
| コントラクト構造とES5パターンのガイド |
| トークン標準仕様 (ZTP20, ZTP721, ZTP1155) |
|
|
| マルチクラスコントラクトアーキテクチャを生成 |
| テストガイド (TEST_INVOKE, TEST_QUERY) |
サポートされているネットワーク
ネットワーク | HTTP RPC | WebSocket |
Mainnet |
|
|
Testnet |
|
|
設定
環境変数
変数 | 説明 | デフォルト |
| ネットワーク選択 ( |
|
| カスタムHTTP RPCエンドポイント (ネットワークデフォルトを上書き) | — |
| カスタムWebSocketエンドポイント (ネットワークデフォルトを上書き) | — |
| トランスポートモード ( |
|
| HTTPサーバーポート ( |
|
| トランザクション署名用のデフォルト秘密鍵 (オプション、会話から鍵を除外) | — |
| トランザクション用のデフォルト送信元アドレス (オプション) | — |
安全なトランザクション (推奨)
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サーバーを追加します:
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=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.comClaude Desktop
Claude Desktop設定ファイルを編集します:
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"
}
}
}
}両方のネットワーク (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"
}
}
}
}カスタム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クライアントがネットワーク経由で接続できるようになります。
サーバーの起動 (デフォルトはmainnet):
ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 ZETRIX_NETWORK=testnet npx zetrix-mcp-serverTestnetを使用する場合:
ZETRIX_TRANSPORT=http ZETRIX_PORT=3000 ZETRIX_NETWORK=testnet npx zetrix-mcp-serverエンドポイント:
エンドポイント | メソッド | 説明 |
| POST | MCPプロトコルエンドポイント (Streamable HTTP) |
| GET | 健全性チェック — |
MCPクライアントから接続:
{
"mcpServers": {
"zetrix": {
"type": "http",
"url": "http://localhost:3000/mcp"
}
}
}両方のネットワーク (mainnet + testnet):
異なるポートで2つのサーバーを実行します:
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
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