Interactive Brokers MCP

🚀 交互式经纪商MCP服务器

这是一个模型上下文协议（MCP）服务器，可与交互式经纪商（Interactive Brokers）的交易平台集成。借助该服务器，AI助手能够与你的IB账户进行交互，实现获取市场数据、查看持仓情况以及下单交易等功能。

🔒 安全声明

⚠️ 重要提示

• 此为非官方的、由社区开发的MCP服务器，与交互式经纪商没有关联，也未得到其认可。该软件处于Alpha阶段，可能无法完美运行。
• 财务风险：交易存在重大亏损风险，请务必先进行模拟交易测试。
• 安全问题：此软件会处理敏感的财务数据，仅可在本地运行，切勿在公共服务器上使用。
• 无保证声明：此非官方软件不提供任何保证，使用风险自负。
• 非财务建议：此工具仅用于自动化操作，并非财务建议。

🚀 快速开始

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

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

首次使用服务器时，会自动打开一个网页浏览器窗口，用于进行交互式经纪商的OAuth认证流程。请使用你的IB凭证登录，以授权连接。

✨ 主要特性

• 账户管理：获取账户信息和余额
• 持仓跟踪：查看当前持仓和盈亏情况
• 市场数据：获取股票和金融工具的实时市场数据
• 订单管理：下达市价单、限价单和止损单
• 订单监控：查看订单状态和执行详情

📦 安装指南

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

• 适用于所有平台（Linux、macOS、Windows）的预配置IB网关
• 用于IB网关的Java运行时环境（JRE）
• 所有必要的依赖项

你仅需具备：

• 交互式经纪商账户（模拟或实盘交易）
• Node.js 18+（用于运行MCP服务器）

💻 使用示例

基础用法

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

高级用法

无头模式配置

对于自动化环境或你不想使用浏览器进行认证的情况，可以通过在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管道
• 不希望进行浏览器交互的情况

重要提示：即使在无头模式下，交互式经纪商仍可能要求进行双因素认证（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"
      }
    }
  }
}

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

📚 详细文档

配置变量

可用的MCP工具

故障排除

认证问题：

• 使用自动打开的网页界面
• 完成任何所需的双因素认证
• 如果实盘交易失败，请尝试模拟交易模式

支持

• 此服务器：请在此仓库中提交问题。

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。