Dry-run-first CCXT MCP with market, account, derivatives, and guarded trading tools.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
这是一个让 Codex CLI 通过 MCP 读取加密货币市场、管理 Binance USDT-M 永续合约,并在本地记录完整交易审计的项目。
GitHub 仓库 · 中文主页 · 演示视频 · 中文社区推广素材 · 5 分钟公开行情教程 · 版本记录 · MCP Registry · 中文试用反馈 · 安全报告
30 秒了解项目: Codex 负责当前会话内的研究和交易决策,ccxt-mcp
提供行情、账户与交易工具,项目本地 skills 约束 V1/V2/V3 流程,
audit-system 记录每轮决策、风控、执行和复核。真实交易默认关闭,首次体验无需
API key 即可读取公共行情并运行 dry-run。
项目包含:
ccxt-mcp/:基于 CCXT 的 MCP stdio 服务,提供行情、账户、订单和交易工具。audit-system/:本地审计记录、复盘界面,以及只读的 trading-intel MCP。V1.txt、V2.txt、V3.txt:三套交易策略和风险边界。.cursor/skills/trading-v*/:Codex 执行对应策略时必须遵循的项目本地 skills。风险提示:本项目可以提交真实合约订单。默认配置关闭真实交易并启用 dry-run。请先在 dry-run 或 Binance 测试环境中验证。任何策略、模型或示例都不保证盈利, 杠杆交易可能导致本金快速损失。
>= 22.13.0 和 npm。检查版本:
安装 Codex CLI(macOS/Linux):
第一次运行 codex 时,按提示使用 ChatGPT 账号或 API key 登录。Codex CLI
安装和认证方式以 OpenAI Codex CLI 文档
为准。
项目根目录没有统一的 npm workspace,因此两个子项目需要分别安装和构建。
创建本地环境文件:
编辑 ccxt-mcp/.env:
.env 已被 .gitignore 忽略。不要把 API key、secret 或完整 .env 提交到 Git、
粘贴到提示词、日志或网页服务。
建议为该项目创建独立且低权限的 Binance API key:
ccxt_proxy_ip 核对出口 IP。ccxt-mcp 和 trading-intel 都是 stdio 服务。通常不需要提前常驻启动,
Codex 会按 MCP 配置自动启动它们。
先取得项目绝对路径:
将下面的 /ABS/PATH/codex-binance-agent 替换为 pwd 输出,然后注册 MCP:
检查配置:
注册后重新启动 Codex 会话。在 Codex TUI 中输入 /mcp,应能看到:
ccxt:市场、账户和交易工具。trading-intel:本地审计分析、CoinGecko 和 DefiLlama 只读工具。Codex 也支持在 ~/.codex/config.toml 或项目的 .codex/config.toml 中直接配置
MCP;详见 Codex MCP 文档。
下面的服务使用 stdio,启动后没有普通终端输出并持续等待输入是正常现象;
按 Ctrl+C 退出:
开发模式:
必须从项目目录启动 Codex,使其读取根目录的 AGENTS.md、策略文件和项目本地
skills:
推荐先执行只读检查:
确认结果中 enableTrading=false、dryRun=true 后,再运行策略。
在 Codex 中输入:
也可以直接从 shell 发起:
V2 是当前 Codex 会话内的连续流程。不要用无人值守脚本、cron 或后台 runner 代替 Codex 做交易决策。
V3 允许 Codex 使用脚本、公开网页和外部数据辅助研究,但最终账户动作必须由当前 Codex 会话判断,并通过已验证的交易工具执行和复核。
| 策略 | 适用方式 | 核心特点 |
|---|---|---|
| V1 | 单轮调用 | 全市场超级短线扫描,多候选和受保护执行。 |
| V2 | 当前会话连续运行 | 默认每 60 秒一轮,包含 cooldown 和更严格的执行质量控制。 |
| V3 | 单轮自由裁量 | 允许自由研究和脚本辅助,先做账户级组合判断。 |
每次策略运行都必须重新读取对应的 V*.txt。策略阈值、风险和交易授权以该文件为准,
执行顺序和审计纪律以对应 .cursor/skills/trading-v*/SKILL.md 为准。
只有完成 dry-run、测试环境验证、API 权限检查和出口 IP 检查后,才考虑修改:
重新启动 Codex,然后先要求它调用 ccxt_get_config。只有返回结果明确显示
enableTrading=true 且 dryRun=false,执行工具才会发送真实交易请求。
真实交易提示词应明确策略版本和范围,例如:
不要仅凭“已调用下单工具”判断交易成功。必须在动作后重新读取:
交易 skill 会把审计数据写入 state/audit/。启动本地复盘界面:
浏览器打开:
常用审计命令:
审计系统本身不会下单、撤单、改仓、转账或提现。
官方 Registry 名称:io.github.lucyfox199818-collab/ccxt-mcp
无需本地构建,直接使用公开 GHCR 镜像:
注册到 Codex:
也可以从源码构建:
使用 Docker 注册 MCP:
更详细的组件文档:
确认两个子项目都已构建且 dist/ 存在,然后重启 Codex。在 TUI 中使用 /mcp
检查初始化错误。
这是 stdio MCP 的正常行为。它正在等待客户端协议消息,不是 HTTP 服务。
公共行情不需要 API key;余额、持仓、订单和成交历史需要正确的 API 凭据和权限。
这是默认安全行为。检查 ccxt_get_config 的 enableTrading 和 dryRun,不要在未完成
测试和风险检查时关闭 dry-run。
.env 后没有生效MCP 进程启动时读取环境变量。退出并重新启动 Codex 会话,让 Codex 重启 MCP 服务。
mypcwzamypcwzaNo reviews yet — be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/codex-ccxt-mcp)<a href="https://allmcps.com/mcp/codex-ccxt-mcp"><img src="https://allmcps.com/api/badge/codex-ccxt-mcp?style=directory" alt="Codex CCXT MCP on AllMCPs" /></a>