xRocket Exchange MCP

xRocket Exchange MCP

设置每日价值限额，让支持 MCP 的 AI Agent 在限额内自主下单和取消 xRocket 现货订单。转账和提现仍是需要明确批准的独立操作。

托管端点仍是公开的行情数据演示和入门途径；它不会接收账户凭据，也无法进行交易。本软件包与 xRocket 无关，也未获其认可。设置交易或打开 xRocket。

交易快速入门

1. 登录 xRocket，然后打开菜单 → 设置 → 交易所设置 → API 令牌。

2. 生成包含每日限额的测试网优先 MCP 配置：

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

3. 将打印出的 JSON 粘贴到本地 MCP 客户端。仅在客户端的本地密钥或环境设置中替换 SET_YOUR_XROCKET_API_TOKEN_LOCALLY。

4. 为客户端提供策略。它可以在任意可用的现货交易对上下达和取消市价单或限价单，直到达到配置的每日价值限额或内置的订单数量限制。

通过测试网验证后，才使用 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

两个市场插件启动时都只提供公开行情工具。需要私有访问权限时，内置技能会处理登录和单限额本地交易设置。

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：10 个无需身份验证的工具，包括组合式的 xrocket_market_snapshot。
• 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 会估算并计算每笔订单的价值，然后仅提交一次。本地持久化账本会在重启后继续执行配置的每日价值限额；对于由其他本地进程产生的用量，则会从当天的 xrmcp-… 交易所历史记录中恢复。每日订单数量和活动订单保护仍是内置功能。默认允许所有现货交易对；高级配置可选用交易对允许列表。结果不明确的订单会继续占用限额，且不会重试。

转账和提现仍会保存精确的预备意图，并且只接受有效期较短、只能使用一次的批准回执。常规交易配置会让这两个开关都保持禁用。

边界

• Exchange API 没有充值地址端点；入门引导仅提供 UI 指引。
• Exchange 转账仅限内部 funding ↔ trading，不支持用户间付款。
• xRocket Pay 是独立产品，不在此范围内。
• WebSocket 通道已完成审计，但 0.6.0 使用有界 REST 快照。
• 金融数值请保留为十进制字符串，并在当前 API 要求时使用 TONCOIN。

完整文档、覆盖范围、安全政策、隐私声明和条款请参阅项目仓库。