wax-mcp-full

v0.1.0 — WAX 블록체인을 위한 로컬 우선 MCP 서버입니다.

AI 호스트(Claude Desktop, Cursor, Grok Build, …)가 계정, 체인 상태, AtomicAssets/AtomicMarket, Hyperion 기록, WAXP 가격을 조회하고, 지갑이 서명할 서명되지 않은 트랜잭션을 준비할 수 있게 합니다. API 키가 필요 없습니다. 메인넷과 테스트넷을 지원합니다.

이것은 초기 공개 릴리스입니다. 보관된 yksanjo/wax-mcp-server(8개 도구, 단일 RPC, 중단된 v1 기록)보다 더 완성도가 높습니다. 1.0이 아닙니다.

기능

또한 리소스(wax://account/{name}, …)와 프롬프트(inspect-account, market-overview, …)를 등록합니다.

요구 사항

• Node.js 20+

• 공개 WAX 길드 API에 HTTPS 접근 (키 불필요)

설치

git clone https://github.com/eoinjosephcurran-code/wax-mcp-full.git
cd wax-mcp-full
npm install
npm run build
node dist/index.js --help

개발 (빌드 없음):

npx tsx src/index.ts --network mainnet

호스트에 추가

/ABSOLUTE/PATH/TO/wax-mcp-full를 클론한 폴더로 바꾸세요.

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "wax": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"],
      "env": { "WAX_NETWORK": "mainnet" }
    }
  }
}

Claude Desktop을 다시 시작하세요.

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "wax": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"]
    }
  }
}

Grok Build

~/.grok/config.toml:

[mcp_servers.wax]
command = "node"
args = ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"]
startup_timeout_sec = 30

또는: grok mcp add wax -- node /ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js

복사-붙여넣기 템플릿은 examples/에 있습니다.

설정

CLI: --network mainnet\|testnet.

https URL만 허용됩니다. 도구는 RPC URL 인수를 받지 않습니다.

eosjs는 기본적으로 설치되지 않습니다. 지갑을 사용하는 것이 좋습니다. 로컬 wax_sign_broadcast를 사용하려면 npm install eosjs와 WAX_ENABLE_SIGNING=1이 필요합니다.

안전

• 준비 도구는 서명되지 않은 JSON을 반환합니다. Anchor, WAX Cloud Wallet 또는 cleos에서 서명하세요.

• wax_simulate_transaction은 절대 브로드캐스트하지 않습니다. 공개 RPC는 종종 서명되지 않은 JSON을 드라이런할 수 없습니다. 이 경우 simulated는 false입니다.

• 개인 키를 채팅이나 도구 인수에 절대 입력하지 마세요.

예시 프롬프트

• "WAXP 가격과 24시간 거래량은 얼마인가요?"

• "eosio의 CPU/NET/RAM과 토큰을 보여주세요."

• "alien.worlds의 최근 AtomicMarket 판매 목록을 보여주세요."

• "alice에서 bob으로 1.00000000 WAX를 전송하는 서명되지 않은 트랜잭션을 준비하세요. 서명하지 마세요."

더 많은 예시는 examples/example-prompts.md에 있습니다.

테스트

npm test           # unit + MCP smoke + live probes (skip-soft if offline)
npm run test:live  # live probes; fail if public APIs are down
npm run typecheck

알려진 제한 사항 (v0.1)

• 공개 Atomic / Hyperion 노드는 느리거나 속도 제한이 있을 수 있습니다.

• 시뮬레이션은 최선의 노력으로 수행되며, 많은 RPC가 서명되지 않은 JSON을 거부합니다.

• MCP 리소스에는 isError 플래그가 없습니다. 실패 시 성공적인 읽기 내부에 JSON이 포함됩니다.

• wax_get_block은 헤더와 transaction_count를 반환하며, 전체 트랜잭션은 반환하지 않습니다.

• 선택적 로컬 서명은 위험합니다. 비활성화 상태로 두세요.

라이선스

MIT