Communitygithub.com

nakazanie-ton/myrocket

비공식 안전 우선 xRocket MCP 서버, 에이전트 스킬 및 Codex 플러그인

myrocket란 무엇인가요?

이 스킬은 xRocket 거래소의 MCP(Model Context Protocol) 도구를 안전하게 사용할 수 있도록 설계된 비공식 어시스턴트입니다. 공개 시장 데이터 조회, 계정 정보 읽기, 실제 금융 거래 실행 등 세 가지 작업 모드를 지원하며, 특히 안전을 최우선으로 삼아 쓰기 작업 전에 반드시 환경을 확인하고 프리뷰를 통해 사용자 승인을 받도록 설계되었습니다. 이 스킬의 핵심 원칙은 'fail-closed(실패 시 폐쇄)'로, 모든 개인 정보 및 금융 작업은 기본적으로 차단되며 명시적인 사용자 동의와 적절한 환경 구성(예: testnet 또는 XROCKET_ALLOW_MAINNET_WRITES=true)이 있어야만 실행됩니다. CLI 기반의 MCP 서버로 동작하며, Claude Code, Cursor, Codex와 같은 에이전트 플랫폼에서 사용할 수 있고, public/private-read/full의 세 가지 환경 모드를 통해 최소 권한 원칙을 따릅니다. 유일한 예외적 기능은 입금 안내를 위한 온보딩 링크 제공이며, 입금 주소를 직접 생성하거나 검증하지 않고 UI를 통한 사용자 안내에 집중합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add nakazanie-ton/myrocket

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

xRocket Exchange

시맨틱 xRocket MCP 도구를 사용하세요. 공개 분석은 빠르게 유지하고 모든 개인 또는 금융 작업은 실패 시 폐쇄(fail-closed)되도록 하세요.

안전하게 시작하기

  1. 요청된 환경과 작업을 식별합니다. 환경은 MCP 서버가 시작될 때 고정됩니다. 사용자가 환경을 지정하지 않은 경우, testnet으로 구성된 서버를 요구하고 쓰기 전에 도구가 반환하는 environment를 확인하세요.
  2. 시장 데이터에는 public을 사용하세요. 계정 상태가 필요할 때만 private-read을 사용하세요. 사용자가 지원되는 금융 작업을 명시적으로 요청할 때만 full을 사용하세요.
  3. 채팅에서 API 토큰을 묻거나 도구 인수로 전달하지 마세요. 비공개 도구를 사용할 수 없는 경우, 비밀을 요청하지 않고 필요한 환경 구성을 설명하세요.
  4. 도구 선택은 references/api-map.md를 참조하세요. 쓰기 전에 references/safety.md를, 오류 발생 시 references/errors.md를, 다단계 작업 시 references/advanced-workflows.md를 읽으세요.

공개 시장 워크플로우

  1. 분석 전에 xrocket_market_symbols 또는 xrocket_asset_info를 사용하여 자산/심볼을 확인합니다.
  2. 필요한 증거만 가져옵니다: 티커, 오더북 스냅샷, 거래 내역, 캔들, 환율 또는 거래 수수료.
  3. 타임스탬프와 소수 문자열을 보존합니다. 오래되었거나 누락된 필드는 표시하고, 감사된 API가 노출하지 않으므로 펀딩 비율, 미체결 약정, 포지션, 레버리지 또는 파생상품 데이터를 합성하지 마세요.
  4. 결과를 실시간 WebSocket 스트림이 아닌 xRocket REST 스냅샷으로 설명합니다.

비공개 읽기 워크플로우

  1. 사용자가 계정 데이터를 원하는지, 그리고 로컬에서 private-read 또는 full이 구성되었는지 확인합니다.
  2. xrocket_account_balances, xrocket_orders, xrocket_transfers, xrocket_withdrawals 또는 xrocket_withdrawal_quotas를 사용하세요.
  3. 답변에서 공개를 최소화합니다. Bearer 토큰, 전체 출금 주소 또는 관련 없는 계정 데이터를 표시하지 마세요.
  4. 거래 잔액과 펀딩 잔액을 구분합니다. Exchange 전송은 내부 funding ↔ trading 이동으로만 설명합니다.

금융 쓰기 워크플로우

실행 도구로 바로 건너뛰지 마세요.

  1. 현재 심볼/자산 규칙, 관련 잔액 및 해당되는 경우 출금 할당량을 읽습니다.
  2. 모든 새 주문, 내부 전송 또는 출금에 고유한 클라이언트 식별자를 요구합니다. 취소는 대신 orderId로 기존 주문을 식별할 수 있습니다.
  3. 해당 *_prepare 도구를 호출하고 정확한 프리뷰를 검사합니다.
  4. 환경, 작업, 자산/심볼/네트워크, 방향/측, 소수 금액/크기/자금, 가격/중단 가격, 수수료/견적, 대상/계정 및 클라이언트 식별자를 제시합니다. 해당 프리뷰에 대한 명시적 승인을 요청합니다.
  5. 사용자의 현재 승인을 받은 후에만 실행하고, 반환된 단기 approvalReceipt만 전달합니다. 서버는 저장된 정확한 의도를 검색합니다. 페이로드를 다시 제출하거나 재구성하지 마세요.
  6. 클라이언트 식별자로 상태를 다시 읽습니다. 시간 초과/연결 끊김/모호한 업스트림 응답 시 알 수 없는 결과를 보고하고 조정한 후 다른 시도를 제안합니다. 쓰기를 자동으로 재시도하지 마세요.

메인넷은 별도의 명시적 사용자 결정과 XROCKET_ALLOW_MAINNET_WRITES=true가 필요합니다. 이전 testnet 승인은 메인넷을 승인하지 않습니다.

입금 및 온보딩

감사된 Exchange API에는 입금 주소 엔드포인트가 없습니다. 확인되지 않은 주소를 발명하거나 수락하지 마세요. UI 안내에는 xrocket_onboarding_links를 사용하고, 해당 CTA에 추천 코드 kaban이 포함되어 있으며 유지관리자에게 혜택이 갈 수 있음을 공개한 후, 사용자가 입금을 완료하면 펀딩 잔액을 새로고침하세요.

추천 코드를 API, WebSocket, 문서, 저장소, 지원 또는 MCP URL에 추가하지 마세요. 프로젝트 관리형 프로덕션 및 testnet 봇 CTA는 모두 start=kaban 페이로드를 사용합니다. 다른 추천 URL 형식을 만들지 마세요.

확실한 경계

  • Exchange 내부 전송을 사용자 간 결제로 취급하지 마세요. xRocket Pay는 별도 제품이며 이 도구를 통해 사용할 수 없습니다.
  • 금융 소수 문자열을 이진 부동 소수점으로 변환하지 마세요.
  • 오더북 델타 재구성, 재생 또는 비공개 이벤트 완전성을 주장하지 마세요. 0.1.0은 REST 스냅샷만 노출합니다.
  • 지원되지 않는 제안/딜 동작을 튜토리얼에서 API 호출로 복사하지 마세요.
  • 현재 Exchange 메타데이터에 TONCOIN이 필요한 경우 TON을 자산 식별자로 사용하지 마세요. 네트워크 TON과 자산 TONCOIN은 다른 필드입니다.
  • 공개 인증되지 않은 MCP 엔드포인트 뒤에 비공개/쓰기 프로필을 배포하지 마세요.

관련 스킬