xRocket Exchange MCP

xRocket Exchange MCP

1 日あたりの取引額上限を設定すると、MCP 対応 AI エージェントがその範囲内で xRocket の現物注文を自律的に発注・キャンセルできます。送金と出金は、個別に明示的な承認が必要な操作として分離されています。

ホスト型エンドポイントは、公開マーケットデータのデモおよび導入経路として提供されており、アカウント認証情報を受け取ることも、取引を行うこともありません。このパッケージは xRocket と提携しておらず、xRocket の推奨を受けているものでもありません。取引を設定するか、xRocket を開く。

取引のクイックスタート

1. xRocket にサインインし、Menu → Settings → Exchange settings → API token を開きます。

2. 1 日あたりの上限を設定して、まずはテストネット用の MCP 設定を生成します。

   npx -y [email protected] trading-config --limit 100 --asset USD
   

3. 出力された JSON をローカルの MCP クライアントに貼り付けます。SET_YOUR_XROCKET_API_TOKEN_LOCALLY は、クライアントのローカルシークレット設定または環境設定でのみ置き換えてください。

4. クライアントに戦略を指示します。設定した 1 日あたりの取引額上限または組み込みの注文数上限に達するまで、利用可能な任意の現物ペアで成行注文または指値注文を発注・キャンセルできます。

テストネットで検証してから、npx -y [email protected] trading-config --limit 100 --asset USD --mainnet を使用してください。送金と出金は無効のままです。

上流のトークンには、文書化されたきめ細かなスコープではなく、アカウントへの広範なアクセス権があります。トークンをチャット、ホスト型エンドポイント、コミットするファイル、課題、ログに決して記載しないでください。

ホスト型マーケットデモ

何もインストールせず、認証情報も入力せずに、接続ページを利用するか、公開されているメインネットのエンドポイントをコピーできます。

https://xrocket-mcp-production.up.railway.app/mcp

公開ツール 10 個のみを提供し、アカウントトークンの読み取りや金融関連の書き込みはできません。取引を求められた場合、オンボーディングツールが上記のローカル設定を案内します。

ローカルのクイックスタート

npx -y [email protected] doctor
npx -y [email protected] config

Node.js 20 以降が必要です。公開マーケットデータの読み取りは設定なしで利用できます。

XROCKET_PROFILE=public
XROCKET_ENVIRONMENT=mainnet

リポジトリのマーケットプレイスから、オールインワンの Codex プラグインをインストールします。

codex plugin marketplace add nakazanie-ton/myrocket --ref main
codex plugin add xrocket-exchange@xrocket-agents

GitHub Copilot CLI では、ポータブルプラグインを直接インストールできます。

copilot plugin install nakazanie-ton/myrocket:plugins/xrocket-exchange

ポータブルインストールでは、ホスト型の公開マーケットツールにのみ接続します。ローカルアカウントへのアクセスが必要な場合は、上記の取引のクイックスタートを使用してください。

Gemini CLI：

gemini extensions install https://github.com/nakazanie-ton/myrocket

ルートの Gemini 拡張機能は、同じホスト型の公開専用エンドポイントと、ローカル取引への引き継ぎ機能を使用します。

Claude Code：

claude plugin marketplace add nakazanie-ton/myrocket
claude plugin install xrocket-exchange@xrocket-agents

どちらのマーケットプレイスプラグインも、公開マーケットツールを使用して起動します。プライベートアクセスが必要な場合は、バンドルされたスキルがサインインと、1 つの上限を設定するローカル取引の手順を案内します。

MCP クライアントの例：

{
  "mcpServers": {
    "xrocket": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "XROCKET_ENVIRONMENT": "mainnet",
        "XROCKET_ENABLE_TRADING": "false",
        "XROCKET_ENABLE_TRANSFERS": "false",
        "XROCKET_ENABLE_WITHDRAWALS": "false",
        "XROCKET_ALLOW_MAINNET_WRITES": "false"
      }
    }
  }
}

ソース開発では、このディレクトリで npm ci、npm test、npm run build を実行してください。

プロファイルと書き込みゲート

• public：合成された xrocket_market_snapshot を含む、認証不要の 10 個のツール。
• private-read：公開ツールに残高、アカウント全体の概要、注文、送金、出金、クォータを追加したもの。XROCKET_API_TOKEN が存在する場合に推定されます。
• full：自律取引に加えて、明示的な送金／出金ワークフローを含むすべてのツール。各機能は、それぞれのゲートが true でない限り無効のままです。

書き込みゲートは XROCKET_ENABLE_TRADING、XROCKET_ENABLE_TRANSFERS、XROCKET_ENABLE_WITHDRAWALS で、すべての既定値は false です。メインネットでの書き込みには、さらに XROCKET_ALLOW_MAINNET_WRITES=true が必要です。

xrocket_agent_trade は、各注文を送信する前に見積もりと評価を 1 回行います。ローカルの永続台帳は、再起動後も設定された 1 日あたりの取引額上限を適用します。また、その日の xrmcp-… 取引履歴から、別のローカルプロセスで発生した利用分を復元します。1 日あたりの注文数と有効注文数のガードも組み込まれています。既定ではすべての現物シンボルが許可されており、上級者向け設定では任意のシンボル許可リストを使用できます。注文の結果が不明確な場合、その注文は上限に対して予約されたままになり、再試行されません。

送金と出金では、引き続き正確な準備済みインテントが保存され、それに対応する有効期間が短く、一度だけ使用できる承認レシートのみが受け付けられます。通常の取引設定では、両方のゲートが無効のままです。

境界

• Exchange APIには入金アドレスのエンドポイントがありません。オンボーディングはUIガイドのみです。
• Exchangeの振替は内部のfunding ↔ trading間で行われ、ユーザー間の送金ではありません。
• xRocket Payは別製品であり、対象に含まれません。
• WebSocketチャンネルは監査済みですが、0.6.0では範囲を限定したRESTスナップショットを使用します。
• 金額は10進数の文字列のまま扱い、現行APIで必要な場合はTONCOINを使用してください。

完全なドキュメント、対応範囲、セキュリティポリシー、プライバシー通知、および利用規約はプロジェクトリポジトリにあります。