Interactive Brokers MCP Server

社区

通过 MCP 连接 Interactive Brokers 账户。

分类: 其他第 193 / 230
Stars: ★ 223 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 3 个月前
工具数: 9

43FMRS · D

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

最强项 · 文档质量 13/20 最弱项 · 安全与权限 3/20

可靠性

7/20

安全与权限

3/20

维护活跃度

8/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: README 描述了认证、Gateway 生命周期和工具列表，但未提供已缓存 manifest、源代码、测试或 CI 证据来验证 MCP 初始化、工具握手、参数一致性及错误处理。项目明确处于 Alpha 状态，且 Gateway、OAuth、Java 和平台依赖增加了未验证的启动风险，因此仅给予中低分。
安全与权限 3/20: 触及账户余额、持仓、市场数据和交易，并支持密码、Flex token、TOTP 密钥等敏感凭据。虽然提供本地运行、纸上交易和只读模式建议，但材料没有证明凭据不会被记录或外传，也没有显示下单前的明确确认或细粒度权限控制；快速配置在未展示确认机制的情况下即可启用交易。按规则这属于未经确认的金融副作用红线，因此安全性评分为 0-4 区间。
维护活跃度 8/20: 仓库未归档，声明 MIT 许可证，并提供 GitHub issue 作为支持渠道；但材料没有发布、提交活动、依赖更新、维护者身份、响应记录或安全响应流程证据。仅凭仓库存在、星标和开放 issue 不能证明持续维护。
文档质量 13/20: README 覆盖安装示例、认证方式、环境变量、纸上交易、Flex Query、Gateway 生命周期、工具概览和部分故障排查，并明确 Alpha、非官方及金融风险。扣分原因是未展示工具参数、返回结构、限制、超时失败语义、成本/速率限制、数据流细节，也缺少可审查的实现或测试证据。
安装易用性 12/20: 提供面向 Cursor/Claude 的 npx 配置，说明 Node.js 18+、OAuth、无头模式、纸上交易及随包 Gateway/JRE，主流平台路径较清晰。扣分原因是认证、2FA、Java/Gateway 启动和本地端口发现依赖较多，且未提供实际运行验证、兼容性测试或常见失败的完整恢复步骤。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据控制浏览器

适合谁

需要从 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 秘钥等敏感配置需要安全保存，不能提交到版本控制。
该工具仅用于自动化，不构成金融建议。

安装接入

准备工作

运行环境：Node.js 18+

IB_PASSWORD_AUTH 可选密钥 IB 账户密码，用于无头模式登录，建议用安全方式存储。

IB_FLEX_TOKEN 可选密钥 Flex Web Service 令牌，在 IB Account Management → Settings → Reporting → Flex Web Service 中生成，Flex Query 功能必需。

IB_TOTP_SECRET 可选密钥 TOTP 两步验证密钥，用于全自动 2FA 覆盖，属敏感信息。

其他可选配置项（14 个）

IB_USERNAME 可选 Interactive Brokers 账户用户名，用于无头模式登录。

IB_HEADLESS_MODE 可选设为 "true" 启用无浏览器凭据登录，适合服务器或自动化环境。

IB_PAPER_TRADING 可选设为 "true" 启用模拟（paper）交易账户。

IB_AUTH_TIMEOUT 可选认证超时时间（秒）。

IB_AUTH_WAIT_SECONDS 可选无头模式下等待 2FA 完成的秒数。

IB_AUTH_POLL_SECONDS 可选认证状态轮询间隔秒数。

IB_FORCE_STANDALONE_GATEWAY 可选设为 "true" 跳过外部 Gateway 发现，强制使用捆绑的独立 Gateway。

IB_READ_ONLY_MODE 可选设为 "true" 启用只读模式，禁用 place_order 下单。

IB_TWO_FA_STRATEGY 可选指定 2FA 处理策略，详见 docs/2FA-TOTP-STRATEGY.md。

IB_SELECTOR_USERNAME 可选无头登录页用户名输入框的 CSS 选择器覆盖。

IB_SELECTOR_PASSWORD 可选无头登录页密码输入框的 CSS 选择器覆盖。

IB_SELECTOR_LOGIN_SUBMIT 可选无头登录页提交按钮的 CSS 选择器覆盖。

IB_SELECTOR_TOTP_INPUT 可选 TOTP 表单输入框的 CSS 选择器覆盖。

IB_SELECTOR_TOTP_SUBMIT 可选 TOTP 表单提交按钮的 CSS 选择器覆盖。

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

.cursor/mcp.json

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

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "interactive-brokers": {
      "command": "npx",
      "args": [
        "-y",
        "interactive-brokers-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add interactive-brokers -- npx -y interactive-brokers-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 get_account_info 等工具；首次调用 get_account_info 会打开浏览器进行 IB OAuth 登录，成功返回账户余额即说明连接正常。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查询我的账户信息和余额
获取 AAPL 的实时行情数据
以限价方式买入 10 股 MSFT
列出我保存的 Flex 查询

工具能力 9

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。

展开其余 1 个工具

forget_flex_query 破坏性

删除已保存的 Flex Query。

使用场景

查询账户余额、持仓和盈亏

获取实时市场数据

监控活动订单和订单状态

提交市价、限价或止损订单

执行并复用 Flex Query 以获取报表和历史数据

支持客户端

Cursor

Claude

依据项目文档列出，未经本站实测。

详细介绍

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