← 返回目录
I

Interactive Brokers MCP Server

社区
通过 MCP 连接 Interactive Brokers 账户。
GitHub 源仓库 ↗
★ 212 Stars 分类 · 其他 热门 源版本 3caecfc5072d
43FMRS · D
可靠性
7/20
安全与权限
3/20
维护活跃度
8/20
文档质量
13/20
安装易用性
12/20

非官方、Alpha 阶段的 Interactive Brokers MCP 服务器,覆盖账户查询、市场数据、订单管理和 Flex Query。它具备较强的交易自动化能力,但涉及真实资金、敏感凭据和本地网关运行,使用前应优先采用纸面交易并严格控制权限。

查看 FMRS 评分方法 →

Interactive Brokers MCP Server 是一个非官方、社区开发且处于 Alpha 阶段的 MCP 服务器,可连接 Interactive Brokers 交易平台,获取账户信息、持仓和实时市场数据,并管理订单。它还支持 Flex Query,用于获取账户报表、交易确认和历史数据。

工具能力

get_account_info
获取账户信息和余额。
get_positions
获取当前持仓和盈亏。
get_market_data
获取交易品种的实时市场数据。
place_order
提交市价单、限价单或止损单;只在未启用只读模式时可用。
get_order_status
查询订单执行状态。
get_live_orders
获取所有活动或未完成订单,用于监控。
get_flex_query
执行 Flex Query 并获取报表;首次执行后会自动保存以便复用。
list_flex_queries
列出此前使用过的 Flex Query。
forget_flex_query
删除已保存的 Flex Query。

安装接入

在支持 MCP 的 Cursor 或 Claude 配置中加入给定的 stdio 配置,并确保已安装 Node.js 18 或更高版本。首次使用时会自动打开浏览器完成 Interactive Brokers OAuth 登录;自动化环境也可配置无头模式和凭据。使用 Flex Query 需额外设置 IB_FLEX_TOKEN。

claude_desktop_config.json
{"mcpServers":{"interactive-brokers":{"command":"npx","args":["-y","interactive-brokers-mcp"]}}}

选型与风险

适合谁

  • 需要从 AI 助手访问 Interactive Brokers 账户的用户
  • 自动化交易或无图形界面环境中的用户
  • 希望使用 Flex Query 获取账户报表和历史数据的用户

不适合谁

  • 需要官方 Interactive Brokers 集成的用户
  • 寻求金融建议的用户
  • 不愿在本地处理敏感金融数据或交易风险的用户

所需权限

  • 需要 Interactive Brokers 账户;可使用纸面交易或真实交易账户。
  • 浏览器模式需要通过 Interactive Brokers OAuth 授权。
  • 无头模式需要配置 IB_USERNAME 和 IB_PASSWORD_AUTH。
  • 下单需要未启用只读模式;纸面交易可通过 IB_PAPER_TRADING 启用。
  • Flex Query 功能需要 IB_FLEX_TOKEN。

风险与副作用

  • 该服务器非 Interactive Brokers 官方产品,也未获其背书。
  • 项目处于 Alpha 阶段,功能可能无法完美运行。
  • 交易存在重大亏损风险;文档建议先使用纸面交易测试。
  • 软件会处理敏感金融数据,文档建议仅在本地运行,不要部署到公共服务器。
  • 凭据和 TOTP 秘钥等敏感配置需要安全保存,不能提交到版本控制。
  • 该工具仅用于自动化,不构成金融建议。

常见排障

  1. 认证失败时,使用自动打开的网页界面并完成所需的双因素认证。
  2. 无头认证触发 2FA 时,在最多 60 秒内完成验证,然后再次检查账户信息。
  3. 实时网关复用或启动异常时,检查本地网关端口以及 ib-gateway/.runtime/ 下的日志和会话文件。
  4. 若不应复用其他本地 IB Gateway,可设置 IB_FORCE_STANDALONE_GATEWAY=true。
  5. 清理过期启动锁前,应确认没有 MCP 进程正在启动 Gateway。

使用场景

查询账户余额、持仓和盈亏
获取实时市场数据
监控活动订单和订单状态
提交市价、限价或止损订单
执行并复用 Flex Query 以获取报表和历史数据

支持客户端

Cursor完整支持
Claude完整支持