Skip to main content
Glama
NexusTrader MCP

NexusTrader MCP

Official

NexusTrader MCP

让 AI 直接成为你的交易界面。

NexusTrader MCP 是一个面向交易团队、量化开发者与 AI 产品团队的 Model Context Protocol server。它把 NexusTrader 的账户、仓位、行情和交易能力安全地暴露给 Claude Code、Cursor、Codex 与 OpenClaw,让你可以直接用自然语言完成查询、分析与执行。

查看 NexusTrader 主项目
查看在线文档
查看 OpenClaw 集成说明
查看完整发布说明

为什么它适合商业推广

  • 把交易接口直接接入 AI 工作流,减少人为切换终端、网页和脚本的成本。

  • 兼容多交易所与多 AI 客户端,适合做内部交易助手、研究 Copilot、客服演示环境和策略运营后台。

  • 本地读取 API 凭证,默认绑定 127.0.0.1,更适合机构内部部署与合规隔离。

  • 同时提供 /sse 与 /mcp 两种入口,便于覆盖不同 MCP 客户端生态。

Related MCP server: rgo-trading-api

核心能力

  • 账户查询:余额、全账户余额汇总。

  • 仓位查询:单标的仓位、全仓位与持仓扫描。

  • 行情查询:ticker、orderbook、K 线、funding rate、mark price、index price。

  • 交易执行:下单、撤单、改单、查询未成交订单。

  • 交易所信息:symbols、market info、exchange info。

支持交易所:

  • Binance

  • Bybit

  • OKX

  • Bitget

  • HyperLiquid

支持客户端:

  • Claude Code

  • Cursor

  • Codex

  • OpenClaw

典型商业场景

  • AI 交易助理:让运营、研究员或交易员直接问“我现在有哪些仓位风险”。

  • 演示环境:为交易基础设施、量化 SaaS 或 AI Agent 产品提供可视化 Demo。

  • 机构内控:让 AI 先完成查询和建议,再由人工确认交易。

  • 研究协作:把行情、持仓和订单状态统一带入 Copilot 流程。

如果你正在评估 AI trading stack,可以同时了解生态关联项目 NexusTrader。但就 NexusTrader MCP 本身而言,使用和部署并不要求本地同时存在 NexusTrader 仓库。

快速开始

1. 准备项目目录

只需要当前仓库即可,API 凭证放在本项目目录下的 .keys/.secrets.toml:

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

2. 安装依赖

要求:

  • Python >=3.11

  • uv

3. 运行初始化向导

cd NexusTrader-mcp
uv run nexustrader-mcp setup

setup 会完成这些工作:

  • 生成 config.yaml

  • 按需写入 Claude Code、Codex、Cursor 配置

  • 在 Linux 环境下安装 OpenClaw skill

  • 在缺少密钥文件时,从模板生成当前项目下的 .keys/.secrets.toml

4. 填写 API 凭证

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

[BINANCE.DEMO]
API_KEY = "your_api_key"
SECRET = "your_secret"

建议先使用测试网或 demo 凭证。

5. 启动服务

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

默认端点:

  • SSE: http://127.0.0.1:18765/sse

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

面向用户的自然语言体验

接入后,用户可以直接对 AI 说:

  • “列出我所有交易所的余额,并按资产规模排序。”

  • “看一下 BTCUSDT-PERP.BINANCE 最近 200 根 1 小时 K 线,总结趋势。”

  • “检查 Binance 上是否有未成交订单。”

  • “如果 BTC 价格接近 68000,就帮我挂一笔 0.01 BTC 的 post-only 买单。”

这类体验尤其适合产品演示、销售 PoC 和内部工作台。

OpenClaw 用户

OpenClaw 在这个仓库里有单独集成层,包含:

  • openclaw/SKILL.md

  • openclaw/bridge.py

  • openclaw/nexustrader_daemon.sh

建议直接阅读:

常用命令

uv run nexustrader-mcp setup
uv run nexustrader-mcp setup --install-only
uv run nexustrader-mcp start
uv run nexustrader-mcp stop
uv run nexustrader-mcp status
uv run nexustrader-mcp logs
uv run nexustrader-mcp serve

安全说明

  • API 凭证从当前项目目录下的 .keys/.secrets.toml 读取,不会写入仓库。

  • MCP 服务默认只监听 127.0.0.1。

  • 下单、撤单、改单会触发真实交易行为。

  • 商业环境建议默认启用测试网,验证完成后再切换实盘。

文档

License

MIT

Available Tools

19 tools
cancel_all_ordersB

撤销指定交易对的所有挂单。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

cancel_orderB

撤销一个挂单。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE oid: 订单 ID

Inputs: oid (required), symbol (required). Returns: object

create_orderA

【真实交易】下单。将在交易所执行真实交易,请谨慎操作。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE side: 方向,BUY 或 SELL type: 订单类型,LIMIT / MARKET / POST_ONLY amount: 数量(字符串,如 "0.01") price: 价格(限价单必填,字符串如 "68000") reduce_only: 是否仅减仓,默认 False

Inputs: side (required), type (required), amount (required), symbol (required), +2 more. Returns: object

get_all_balancesA

获取所有已配置账户的余额。

Inputs: no named parameters. Returns: result

get_all_positionsA

获取所有持仓,可按交易所过滤。

Args: exchange: 可选,交易所名称过滤,如 binance / bybit / okx

Inputs: exchange. Returns: result

get_balanceB

获取指定交易所/账户类型的余额。

Args: exchange: 交易所名称,如 binance / bybit / okx account_type: 账户类型,如 USD_M_FUTURE_TESTNET / LINEAR

Inputs: exchange (required), account_type (required). Returns: object

get_exchange_infoA

获取已配置的交易所及其连接状态。

Inputs: no named parameters. Returns: result

get_funding_rateA

获取缓存中的资金费率。需要先预订阅 funding_rate。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

get_index_priceA

获取缓存中的指数价格。需要先预订阅 index_price。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

get_klinesA

获取历史 K 线数据(REST 请求)。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE interval: K 线周期,可选 1m/5m/15m/30m/1h/4h/1d 等 limit: 返回条数,默认 100

Inputs: symbol (required), limit, interval. Returns: result

get_market_infoA

获取指定交易对的市场详情(精度、最小数量等)。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

get_mark_priceA

获取缓存中的标记价格。需要先预订阅 mark_price。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

get_open_ordersA

获取所有挂单。必须提供 symbol 或 exchange 之一。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE exchange: 交易所名称,如 binance

Inputs: symbol, exchange. Returns: result

get_orderB

获取指定订单的详细信息。

Args: oid: 订单 ID

Inputs: oid (required). Returns: object

get_orderbookA

获取缓存中的最优买卖价(L1 盘口)。需要先预订阅 bookl1。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

get_positionA

获取指定交易对的持仓信息。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

get_symbolsB

列出交易所可用交易对。

Args: exchange: 交易所名称,如 binance / bybit / okx instrument_type: 可选,过滤合约类型:linear / spot / inverse

Inputs: exchange (required), instrument_type. Returns: result

get_tickerA

获取指定交易对的最新行情(REST 请求,非缓存)。

Args: symbol: 交易对,如 BTCUSDT-PERP.BINANCE

Inputs: symbol (required). Returns: object

modify_orderA

修改一个挂单的价格和数量。

Args: symbol: 交易对 oid: 要修改的订单 ID price: 新价格 amount: 新数量 side: 新方向(可选,不提供则保持原方向)

Inputs: oid (required), price (required), amount (required), symbol (required), +1 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 19 tools

    Disambiguation5/5

    Each tool targets a distinct resource/action: balances, positions, market data, order management, and exchange metadata. Even similar pairs like get_balance/get_all_balances and get_order/get_open_orders are clearly separated by specificity.

    Naming Consistency4/5

    The toolset mostly follows a consistent get_<noun> / <verb>_order pattern, with create_order, cancel_order, cancel_all_orders, and modify_order forming a clear action set. Minor deviations like get_all_balances and get_orderbook (compound noun without underscore) are still readable and predictable.

    Tool Count4/5

    At 19 tools, the server is slightly heavy but each tool earns its place given the breadth of trading operations: account, positions, market data, order lifecycle, and instrument metadata. There is no meaningful redundancy.

    Completeness3/5

    Core trading workflows are covered well, but several market data tools (orderbook, funding, mark, index) require pre-subscriptions that are not exposed via any tool, creating dead ends. Order/trade history is also missing, so agents cannot inspect past fills.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI models with secure access to Interactive Brokers trading data and functionality, enabling account management, market data retrieval, and trading operations through natural language interactions.
      18
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read positions, deals, and orders from the RGO trading platform via natural language, with optional trading capabilities when explicitly enabled.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to trade on MetaTrader 5 using natural language, supporting account management, order placement, and real-time market data.
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants and traders to connect to a local MetaTrader 5 terminal, fetch historical market data, run strategy backtests, monitor account status, and manage demo trades via natural language, with an interactive web GUI.
      2
      -