Interactive Brokers MCP 服务器

免责声明：这是一个非官方、社区开发的 MCP 服务器，不隶属于 Interactive Brokers，也未得到其认可。本软件处于Alpha 阶段，可能无法完美运行。

一个提供与 Interactive Brokers 交易平台集成的模型上下文协议 (MCP) 服务器。该服务器允许 AI 助手与您的 IB 账户交互，以获取市场数据、检查持仓和下单。

🔒 安全须知

Related MCP server: Interactive Brokers MCP Server

功能

• Interactive Brokers API 集成：完整的交易功能，包括账户管理、持仓跟踪、实时市场数据和订单管理（市价单、限价单和止损单）

• Flex Query 支持：执行 Flex 查询以获取账户报表、交易确认和历史数据。查询会自动保存以便轻松重复使用

• 灵活的身份验证：支持基于浏览器的 OAuth 身份验证或带有凭据的无头模式（适用于自动化环境）

• 简单设置：直接使用 npx 运行 - 无需 Docker 或额外安装。包含适用于所有平台的预配置 IB Gateway 和 Java 运行时

安全须知

重要警告：

• 财务风险：交易涉及巨大的亏损风险。请务必先进行模拟交易测试。

• 安全性：本软件处理敏感的财务数据。请仅在本地运行，切勿在公共服务器上运行。

• 无担保：此非官方软件不提供任何担保。使用风险自负。

• 非财务建议：此工具仅用于自动化，而非财务建议。

先决条件

无需额外安装！ 本软件包包含：

• 适用于所有平台（Linux、macOS、Windows）的预配置 IB Gateway

• 用于 IB Gateway 的 Java 运行时环境 (JRE)，包括适用于 Alpine 容器（例如 node:lts-alpine，supergateway）的 musl-libc 构建版本

• 所有必要的依赖项

您只需要：

• Interactive Brokers 账户（模拟或实盘交易）

• Node.js 18+（用于运行 MCP 服务器）

快速入门

将此 MCP 服务器添加到您的 Cursor/Claude 配置中：

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

首次使用该服务器时，Web 浏览器窗口将自动打开以进行 Interactive Brokers OAuth 身份验证流程。使用您的 IB 凭据登录以授权连接。

无头模式配置

对于自动化环境，或者当您不想使用浏览器进行身份验证时，可以通过在 MCP 服务器配置中进行配置来启用无头模式：

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password"
      }
    }
  }
}

在无头模式下，服务器将自动使用您的凭据进行身份验证，而无需打开浏览器窗口。这适用于：

• 自动化交易系统

• 无显示器的服务器环境

• CI/CD 流水线

• 不希望进行浏览器交互的情况

重要提示：即使在无头模式下，Interactive Brokers 可能仍需要双重身份验证 (2FA)。当触发 2FA 时，无头身份验证将等待您通过配置的方法（移动应用、短信等）完成 2FA 流程后再继续。

要启用模拟交易，请将 "IB_PAPER_TRADING": "true" 添加到您的环境变量中：

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password",
        "IB_PAPER_TRADING": "true"
      }
    }
  }
}

安全提示：请安全存储凭据，切勿将其提交到版本控制系统中。考虑使用环境变量文件或安全凭据管理系统。

Flex Query 配置（可选）

要使用 Flex Query 获取账户报表和历史数据，您需要配置您的 Flex Web 服务令牌：

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

如何获取您的 Flex 令牌：

1. 登录 Interactive Brokers 账户管理

2. 转到 设置 (Settings) → 账户设置 (Account Settings)

3. 导航到 报告 (Reporting) → Flex Web 服务 (Flex Web Service)

4. 生成或获取您的 Flex Web 服务令牌

有关启用 Flex Web 服务的详细说明，请参阅 IB Flex Web 服务指南。

创建 Flex 查询：

1. 在账户管理中转到 报告 (Reports) → Flex 查询 (Flex Queries)

2. 创建或自定义您的查询模板

3. 点击查询旁边的信息图标以查找其查询 ID

有关创建和自定义 Flex 查询的完整指南，请参阅 IB Flex 查询指南。

注意：当您首次执行 Flex 查询时，MCP 服务器会自动将其名称从 API 保存下来。以后的执行可以通过其 ID 或保存的名称来引用该查询。

Flex 查询功能：

• 自动记忆：当您执行 Flex 查询时，它会自动保存以供将来使用

• 轻松重用：记住之前使用的查询 - 无需重复复制查询 ID

• 友好名称：首次执行查询时，可选择提供友好名称

• 忘记查询：使用 forget_flex_query 工具删除不再需要的查询

配置变量

可用的 MCP 工具

交易与账户管理

Flex 查询（需要 IB_FLEX_TOKEN）

故障排除

身份验证问题：

• 使用自动打开的 Web 界面

• 完成任何必需的双重身份验证

• 如果实盘交易失败，请尝试模拟交易模式

支持

• 本服务器：在此存储库中提交问题。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

感谢我们的贡献者

非常感谢所有为使本项目变得更好而做出贡献的人。