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 文件。