Interactive Brokers MCP

🚀 Interactive Brokers MCP Server

Interactive Brokersの取引プラットフォームとの統合を提供するModel Context Protocol (MCP)サーバーです。このサーバーを使用すると、AIアシスタントがあなたのIB口座とやり取りして、市場データの取得、ポジションの確認、取引の実行が可能になります。

🚀 クイックスタート

このMCPサーバーをCursor/Claudeの設定に追加します。

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

サーバーを初めて使用するときは、ウェブブラウザのウィンドウが自動的に開き、Interactive BrokersのOAuth認証フローが開始されます。IBの資格情報でログインして接続を承認してください。

✨ 主な機能

• 口座管理：口座情報と残高を取得
• ポジション追跡：現在のポジションと損益を表示
• 市場データ：株式や商品のリアルタイム市場データ
• 注文管理：成行注文、指値注文、逆指値注文を発注
• 注文監視：注文ステータスと約定詳細を確認

📦 インストール

追加のインストールは必要ありません！ このパッケージには以下が含まれています。

• すべてのプラットフォーム（Linux、macOS、Windows）用に事前設定されたIB Gateway
• IB Gateway用のJava Runtime Environment (JRE)
• すべての必要な依存関係

必要なものは以下のみです。

• Interactive Brokersの口座（シミュレーション取引または実際の取引）
• Node.js 18以上（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パイプライン
• ブラウザとの対話が望ましくない状況

重要: ヘッドレスモードでも、Interactive Brokersは2要素認証（2FA）を要求する場合があります。2FAがトリガーされると、ヘッドレス認証は、あなたが設定した方法（モバイルアプリ、SMSなど）で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ツール

トラブルシューティング

認証問題

• 自動的に開くウェブインターフェイスを使用する
• 必要な2要素認証を完了する
• 実際の取引で失敗した場合は、シミュレーション取引モードを試す

サポート

• このサーバー：このリポジトリでissueを開いてください。

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

⚠️ 重要提示

これは非公式の、コミュニティ開発のMCPサーバーであり、Interactive Brokersとは関係がなく、承認もされていません。このソフトウェアはアルファ版であり、完全に動作するとは限りません。

⚠️ 重要警告

• 金融リスク: 取引には損失の大きなリスクが伴います。必ずまずシミュレーション取引でテストしてください。
• セキュリティ: このソフトウェアは機密性の高い金融データを扱います。常にローカルで実行し、公開サーバーでは実行しないでください。
• 保証なし: この非公式ソフトウェアには保証がありません。自己責任で使用してください。
• 金融アドバイスではない: このツールは自動化のみを目的としており、金融アドバイスではありません。

💡 使用建议

資格情報は安全に保管し、バージョン管理システムにコミットしないでください。環境変数ファイルや安全な資格情報管理システムの使用を検討してください。