Skip to main content
Glama
Zetrix-Chain

Zetrix MCP Server

Official
by Zetrix-Chain

Zetrix 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

ガイド:

機能 (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

トランザクションを16進数にシリアライズ

zetrix_submit_transaction

署名済みトランザクションを送信

コントラクトクエリ (2ツール)

ツール

説明

zetrix_call_contract

サンドボックス内でコントラクトを呼び出し (読み取り専用)

zetrix_test_transaction

送信せずに手数料を評価

WebSocket — リアルタイム (5ツール)

Zetrixノードとの通信にはprotobufバイナリエンコーディングを使用します。

ツール

説明

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

アカウントのナンスを取得

zetrix_sdk_call_contract

SDK経由でコントラクトを呼び出し (読み取り専用)

SDKトランザクション (11ツール)

すべてのトランザクションツールは、動的なガス価格設定のために evaluateFee (testTransaction) を使用します。すべての操作でオプションの 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

ガス支払い付きでコントラクトを呼び出し

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

秘密鍵でメッセージ (16進数) に署名

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

Mainnet

https://node.zetrix.com

wss://ws-node.zetrix.com

Testnet

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_KEYZETRIX_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=mainnet

Testnet:

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

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_URLZETRIX_WS_URL は、選択したネットワークのデフォルトエンドポイントを上書きします。片方だけ、または両方を上書きできます。設定されていない場合は、上記の表のデフォルトが使用されます。

HTTPトランスポート (APIサーバー)

Streamable HTTPトランスポートを使用して、MCPサーバーをHTTP APIサーバーとして実行します。これにより、リモートのMCPクライアントがネットワーク経由で接続できるようになります。

サーバーの起動 (デフォルトはmainnet):

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

Testnetを使用する場合:

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

両方のネットワーク (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

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