Codex Binance Agent

这是一个让 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 测试环境中验证。任何策略、模型或示例都不保证盈利， 杠杆交易可能导致本金快速损失。

环境要求

• Linux、macOS 或 WSL2。
• Node.js >= 22.13.0 和 npm。
• Codex CLI。
• 可选：Binance API key、网络代理、Docker。

检查版本：

node --version
npm --version
codex --version

安装 Codex CLI（macOS/Linux）：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

第一次运行 codex 时，按提示使用 ChatGPT 账号或 API key 登录。Codex CLI 安装和认证方式以 OpenAI Codex CLI 文档 为准。

安装项目

git clone https://github.com/lucyfox199818-collab/codex-binance-agent.git
cd codex-binance-agent

cd ccxt-mcp
npm ci
npm run build

cd ../audit-system
npm ci
npm run build

cd ..

项目根目录没有统一的 npm workspace，因此两个子项目需要分别安装和构建。

配置交易所

创建本地环境文件：

cp ccxt-mcp/.env.example ccxt-mcp/.env

编辑 ccxt-mcp/.env：

# 可选。无代理时删除这一行或留空。
TRADINGAGENTS_PROXY_URL=http://127.0.0.1:7890

# 只读取公共行情时可以留空；读取账户或交易时必须填写。
BINANCE_API_KEY=
BINANCE_API_SECRET=

CCXT_EXCHANGE_ID=binance
CCXT_DEFAULT_TYPE=future
CCXT_SANDBOX=false
CCXT_TIMEOUT_MS=30000

# 初次使用必须保持以下默认值。
CCXT_ENABLE_TRADING=false
CCXT_DRY_RUN=true

.env 已被 .gitignore 忽略。不要把 API key、secret 或完整 .env 提交到 Git、 粘贴到提示词、日志或网页服务。

建议为该项目创建独立且低权限的 Binance API key：

• 只启用需要的读取和合约交易权限。
• 禁用提现权限。
• 配置 IP 白名单，并先用 ccxt_proxy_ip 核对出口 IP。
• 不要复用持有大量资产的主账户密钥。

配置 MCP

ccxt-mcp 和 trading-intel 都是 stdio 服务。通常不需要提前常驻启动， Codex 会按 MCP 配置自动启动它们。

先取得项目绝对路径：

cd /path/to/codex-binance-agent
pwd

将下面的 /ABS/PATH/codex-binance-agent 替换为 pwd 输出，然后注册 MCP：

codex mcp add ccxt -- \
  bash -lc 'cd /ABS/PATH/codex-binance-agent/ccxt-mcp && exec node dist/index.js'

codex mcp add trading-intel \
  --env AUDIT_DATA_DIR=/ABS/PATH/codex-binance-agent/state/audit -- \
  bash -lc 'cd /ABS/PATH/codex-binance-agent/audit-system && exec node dist/mcp/index.js'

检查配置：

codex mcp list
codex mcp get ccxt
codex mcp get trading-intel

注册后重新启动 Codex 会话。在 Codex TUI 中输入 /mcp，应能看到：

• ccxt：市场、账户和交易工具。
• trading-intel：本地审计分析、CoinGecko 和 DefiLlama 只读工

... View full README on GitHub