适合谁
- 需要通过 AI 客户端访问 OKX 的用户
- 希望在本地运行交易 MCP 服务器的开发者
- 需要同时使用行情、交易、账户和收益模块的 OKX 用户
O
51FMRS · D
来源显示该项目由 OKX 维护，采用 MIT 许可证，以本地 stdio 进程提供 11 个模块、167 个工具的交易与账户能力。README 明确支持多个 MCP 客户端，并提供只读模式、模块过滤和速率限制；但完整服务器清单未缓存，因此无法列出具体工具标识符。
OKX Agent Trade Kit 是一个本地运行的 OKX 交易 MCP 服务器，支持市场数据、现货、永续合约、交割合约、期权、账户、收益、交易机器人、事件合约、新闻和智能资金分析等功能。它通过 Model Context Protocol 连接 Claude、Cursor 及其他兼容客户端，API 密钥仅保存在本机。
工具能力
暂未整理工具清单。
安装接入
需要 Node.js 18 或更高版本。运行 npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli 安装软件包，然后运行 okx config init 配置 OKX API 凭证。使用 okx-trade-mcp setup --client claude-desktop、okx-trade-mcp setup --client cursor、okx-trade-mcp setup --client claude-code 或 okx-trade-mcp setup --client vscode 注册 MCP 服务器。
选型与风险
不适合谁
- 不使用 OKX 的用户
- 只需要静态文档或离线数据的用户
- 不希望 AI 客户端接触交易或账户 API 权限的用户
所需权限
- 需要配置 OKX API 凭证才能使用需要鉴权的功能
- market 模块可在无需鉴权的情况下提供部分市场数据
- 可使用 --read-only 限制为查询工具
- 不同模块需要通过 --modules 选择启用
风险与副作用
- 启用交易或收益模块后，AI 可能代表用户执行真实操作
- API 凭证权限范围会影响可执行的账户和交易操作
- 交易、机器人和收益操作可能带来资金损失或其他市场风险
- OKX Outcomes 功能需要单独的 okx-outcomes 二进制，并包含受 dry-run 控制的交易功能
常见排障
- 确认 Node.js 版本至少为 18
- 先运行 okx config init 检查 API 凭证配置
- 确认启动时选择了包含目标功能的模块
- 使用 --read-only 排查是否为写入权限或交易调用问题
- 查看 MCP 返回的结构化错误中的 tool、code、message 和 endpoint 字段
- CLI 子命令使用空格；MCP 工具名称使用下划线，不能混用
- 使用 Outcomes 功能时确认已通过 install.sh 安装外部 okx-outcomes 二进制
使用场景
查询行情、订单簿、K 线、资金费率和技术指标
管理现货、永续合约、交割合约和期权订单
查看账户余额、持仓、成交和费用信息
配置网格或 DCA 交易机器人
查询新闻、情绪和智能资金信号
使用 Simple Earn、链上质押或双币赢功能
支持客户端
Claude Desktop完整支持
Cursor完整支持
Claude Code完整支持
Visual Studio Code完整支持
Windsurf部分支持