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(Model Context Protocol) 서버입니다. 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개 도구)

도구	설명
`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`	계정 논스(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
메인넷	`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은 키를 보지 않고도 "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이 대화 중에 개인 키와 소스 주소를 요청하거나 제공받아야 합니다. 설정된 경우 기본값으로 사용되지만, 필요한 경우 도구 호출마다 재정의할 수 있습니다.

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