交互经纪商-mcp

Name: 交互经纪商-mcp
Author: code-rabi

作者：code-rabi44 星标更新：2025-11-06

安装使用来源：spider==github.com

项目介绍

Interactive Brokers MCP Server

免责声明：这是一个由社区开发的非官方MCP服务器，并且未获得Interactive Brokers的认可或支持。此软件处于Alpha状态，可能无法完美运行。

一个提供与Interactive Brokers交易平台集成的Model Context Protocol (MCP)服务器。该服务器允许AI助手与您的IB账户交互，以获取市场数据、检查仓位并下单。

🔒 安全通知

Interactive Brokers MCP 展示

特性

Interactive Brokers API 集成：包括账户管理、仓位跟踪、实时市场数据和订单管理（市价单、限价单和止损单）在内的完整交易能力。
Flex 查询支持：执行Flex查询以检索账户报表、交易确认和历史数据。查询会自动保存以便于重复使用。
灵活的身份验证：可以选择基于浏览器的OAuth身份验证或无头模式，使用凭证进行自动化环境的身份验证。
简单设置：可以直接使用npx运行，无需Docker或其他安装。包含预配置的IB网关和适用于所有平台的Java运行时。

安全通知

重要警告：

财务风险：交易涉及重大损失风险。始终先用模拟交易测试。
安全：此软件处理敏感的金融数据。仅在本地运行，切勿在公共服务器上运行。
无保证：此非官方软件不提供任何保证。自行承担风险使用。
非财务建议：此工具仅用于自动化，而非财务建议。

先决条件

无需额外安装！ 此包包括：

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

您只需要：

Interactive Brokers账户（模拟或实盘交易）
Node.js 18+（用于运行MCP服务器）

快速开始

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

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

首次使用服务器时，会自动打开一个网页浏览器窗口进行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 查询配置（可选）

要使用Flex查询检索账户报表和历史数据，您需要配置您的Flex Web服务令牌：

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

如何获取您的Flex令牌：

登录到Interactive Brokers账户管理
前往设置→账户设置
导航至报告→Flex Web服务
生成或检索您的Flex Web服务令牌

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

创建Flex查询：

在账户管理中前往报告→Flex查询
创建或自定义查询模板
点击查询旁边的info图标找到其Query ID

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

注意：当您第一次执行Flex查询时，MCP服务器会自动保存它及其从API获取的名称。未来执行可以参考查询ID或其保存的名称。

Flex查询特性：

自动记忆：执行Flex查询时，它会被自动保存以供将来使用
轻松重用：之前使用的查询会被记住——无需反复复制查询ID
友好名称：首次执行查询时可选择提供一个友好名称
忘记查询：使用forget_flex_query工具移除不再需要的查询

配置变量

功能	环境变量	命令行参数
用户名	`IB_USERNAME`	`--ib-username`
密码	`IB_PASSWORD_AUTH`	`--ib-password-auth`
无头模式	`IB_HEADLESS_MODE`	`--ib-headless-mode`
模拟交易	`IB_PAPER_TRADING`	`--ib-paper-trading`
认证超时	`IB_AUTH_TIMEOUT`	`--ib-auth-timeout`
Flex令牌	`IB_FLEX_TOKEN`	N/A

可用的MCP工具

交易及账户管理

工具	描述
`get_account_info`	获取账户信息和余额
`get_positions`	获取当前仓位和盈亏
`get_market_data`	获取符号的实时市场数据
`place_order`	下市价单、限价单或止损单
`get_order_status`	检查订单执行状态
`get_live_orders`	获取所有活跃/开放订单以进行监控

Flex查询（需IB_FLEX_TOKEN）

工具	描述
`get_flex_query`	执行Flex查询并检索报表（自动保存以供重复使用）
`list_flex_queries`	列出所有之前使用的Flex查询
`forget_flex_query`	从内存中移除已保存的Flex查询

故障排除

认证问题：

使用自动打开的网页界面
完成任何所需的两步验证
如果实盘交易失败，尝试模拟交易模式

支持

此服务器：在此仓库中打开一个问题。

许可证

MIT许可证 - 详情见LICENSE文件。