快速上手

项目定位

NexusTrader MCP 把交易查询和交易执行能力暴露给 AI 客户端。你可以把它理解为：

  • NexusTrader MCP：当前仓库，负责 AI 接入层与自然语言操作层

  • NexusTrader：生态关联项目，可作为补充了解

如果你想做可演示、可集成、可扩展的 AI trading workflow，可以额外了解 NexusTrader。但运行 NexusTrader MCP 并不要求本地同时存在那个仓库。

环境要求

  • Python >=3.11

  • uv

  • 当前项目目录下存在 .keys/.secrets.toml

目录建议：

NexusTrader-mcp/
├─ .keys/
│  └─ .secrets.toml
├─ docs/
├─ nexustrader_mcp/
└─ README.md

初始化

cd NexusTrader-mcp
uv run nexustrader-mcp setup

初始化向导会：

  • 生成 config.yaml

  • 写入 Claude Code、Codex、Cursor 配置

  • 在 Linux 上安装 OpenClaw skill

  • 自动创建当前项目下的 .keys/.secrets.toml 模板文件

配置凭证

编辑当前项目目录下的 .keys/.secrets.toml：

[BINANCE.DEMO]
API_KEY = "your_demo_key"
SECRET = "your_demo_secret"

建议流程：

  1. 先填测试网或 demo key。

  2. 先做余额、行情、持仓查询。

  3. 最后再测试下单与改单。

启动与运维

uv run nexustrader-mcp start
uv run nexustrader-mcp status
uv run nexustrader-mcp logs
uv run nexustrader-mcp stop

默认端口：

  • Claude Code / Cursor / OpenClaw: http://127.0.0.1:18765/sse

  • Codex: http://127.0.0.1:18765/mcp

常见自然语言用法

  • “列出我所有账户余额。”

  • “看看 Binance 上 BTC 永续的盘口和资金费率。”

  • “列出未成交订单。”

  • “把那笔订单撤掉。”

商业落地建议

  • 对外演示时，把 README 当成首页，把 docs/ 当成交付文档。

  • 对内部署时，把 AI 访问权限和实盘 API key 严格隔离。

  • 对客户销售时，可以补充介绍 NexusTrader 作为生态关联项目，但不要把它写成当前仓库的强依赖。