/ 目录 / 演练场 / agent-trade-kit
● 社区 okx ⚡ 即开即用

agent-trade-kit

作者 okx · okx/agent-trade-kit

OKX 官方相邻的交易 MCP——112 个工具覆盖现货、永续合约、期货、期权、网格/DCA 机器人——提供只读模式和本地凭据存储。

agent-trade-kit 是一个 Node MCP,用于 OKX 交易。覆盖行情数据、现货、永续合约、期货、期权、收益、账户和算法/机器人策略——8 个模块 112 个工具。凭据保存在本地(无云中继)。提供 --read-only 标志用于仅分析使用。

为什么要用

核心特性

实时演示

实际使用效果

agent-trade-kit.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-trade-kit",
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-trade-kit": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "agent-trade-kit"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add agent-trade-kit -- npx -y agent-trade-kit

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: agent-trade-kit

在决定交易前研究资产(只读模式)

👤 执行尽职调查的加密交易员 ⏱ ~20 min advanced

何时使用: 你正在考虑建立头寸,想要一次性获得图表 + 指标 + 订单簿快照——没有意外交易的风险。

前置条件
  • OKX API 密钥(只读权限) — OKX > API > 创建具有只读权限的密钥
步骤
  1. 以只读模式启动
    用 --read-only 配置 agent-trade-kit。确认交易工具已禁用。✓ 已复制
    → 仅启用研究工具
  2. 获取数据
    对于 SOL-USDT:最近 30 天的 4 小时蜡烛线、RSI(14)、MACD、当前资金费率、顶级订单簿深度和持仓量趋势。✓ 已复制
    → 指标堆栈
  3. 综合分析
    短期技术面如何,与资金费率/持仓量是否一致?✓ 已复制
    → 分析

结果: 有依据的观点,无执行风险。

注意事项
  • 技术分析不是预测引擎 — 将其用作一个输入;本身不是交易信号

在保守参数范围内设置网格机器人

👤 探索网格策略的加密交易员 ⏱ ~30 min advanced

何时使用: 你想要对一个你认为会震荡的交易对进行区间绑定的网格。

前置条件
  • 有资金的 OKX 账户 — 真实资金处于风险中——谨慎行动
  • 完整 API 密钥(交易权限) — OKX > API;不要启用提现
步骤
  1. 规划
    对于 ETH-USDT 现货:分析过去 30 天的范围。提议一个网格:40 个网格、范围 $2800-$3400、每个网格投资 $50。显示预期收益。✓ 已复制
    → 带有假设的网格计划
  2. 确认并创建
    在下单前:确认参数。如果我说'执行',就创建网格机器人;否则中止。✓ 已复制
    → 明确的确认门闸

结果: 网格机器人运行,风险规模恰当。

注意事项
  • 范围突破 = 网格亏损 — 在范围外设置止损价格;每周审查
  • LLM 订单大小设置错误——真实资金丧失 — 初始规模小;在确认前验证每个参数

检查投资组合盈亏和未平仓头寸

👤 活跃交易员 ⏱ ~5 min intermediate

何时使用: 早晨检查——我有哪些未平仓头寸,它们表现如何,有什么保证金风险吗?

步骤
  1. 获取账户状态
    列出所有未平仓头寸(现货 + 永续合约 + 期货)及其未实现盈亏。显示账户权益 + 维持保证金比率。✓ 已复制
    → 投资组合快照
  2. 风险检查
    哪个头寸面临最高的清算风险?距离其清算价格还有多远?✓ 已复制
    → 风险排名

结果: 具有风险意识的早晨检查。

组合

与其他 MCP 搭配,撬动十倍杠杆

agent-trade-kit + filesystem

将每次交易执行本地记录以用于税务/审计

每次交易后,将 instrument/side/size/price/ts 追加到 ~/trades/YYYY-MM.csv。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
market_candles instrument, bar, limit? 价格数据 1 API call
market_book instrument, depth 流动性检查 1 API call
account_balance 账户状态 1 API call
spot_place_order instrument, side, size, type, price? 现货交易——危险操作;请确认! 1 API call + real money
grid_bot_create instrument, range, levels, total_investment 启动网格策略——危险操作;请确认! 1 API call + real money

成本与限制

运行它的成本

API 配额
OKX API 对每个端点都有速率限制
每次调用 Token 数
蜡烛线/订单簿可能很大——通过 limit 参数进行修剪
费用
免费 MCP。交易产生 OKX 费用 + 真实资金风险。
提示
在你读完工具列表并信任你的提示纪律之前,使用 --read-only。

安全

权限、密钥、影响范围

最小权限: API 密钥从不具有提现权限
凭据存储: 通过 okx config init 本地存储——保存在磁盘上
数据出站: 到 OKX API;账户数据到你的 LLM 提供者
切勿授予: 用于 LLM 的 API 密钥的提现权限

故障排查

常见错误与修复

Signature invalid

API 密钥/密码/通行短语不匹配。重新运行 okx config init。也要检查服务器时钟(API 对时间敏感)。

Insufficient balance for order

将资金转到交易账户(OKX 有多个钱包)。

Tool missing when expected

按模块过滤可能会阻止它;检查配置。

替代方案

agent-trade-kit 对比其他方案

替代方案何时用它替代权衡
Hummingbot / 自定义机器人框架你想要非 LLM 自动交易代码实现,无 LLM;更具确定性
直接 OKX API你想要完全控制并能自审计构建你自己的包装器

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills