Interactive Brokers MCPサーバー

免責事項: これはコミュニティによって開発された非公式のMCPサーバーであり、Interactive Brokersとは一切関係がなく、推奨もされていません。このソフトウェアはアルファ版であり、完全に動作しない可能性があります。

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

🔒 セキュリティに関する注意

Related MCP server: Interactive Brokers MCP Server

機能

• Interactive Brokers API統合: 口座管理、ポジション追跡、リアルタイム市場データ、注文管理（成行、指値、逆指値注文）を含む完全な取引機能

• Flex Queryサポート: Flex Queryを実行して、口座明細、約定確認、履歴データを取得します。クエリは自動的に記憶され、簡単に再利用できます

• 柔軟な認証: ブラウザベースのOAuth認証、または自動化環境向けの資格情報を使用したヘッドレスモードを選択可能

• 簡単なセットアップ: npxで直接実行可能 - Dockerや追加のインストールは不要です。すべてのプラットフォーム向けに設定済みのIB GatewayとJavaランタイムが含まれています

セキュリティに関する注意

重要な警告:

• 財務リスク: 取引には多額の損失リスクが伴います。必ず最初にペーパートレードでテストしてください。

• セキュリティ: このソフトウェアは機密性の高い財務データを扱います。ローカル環境でのみ実行し、公開サーバーでは決して実行しないでください。

• 無保証: この非公式ソフトウェアにはいかなる保証もありません。自己責任で使用してください。

• 投資助言ではありません: このツールは自動化のみを目的としており、投資助言ではありません。

前提条件

追加のインストールは不要です！ このパッケージには以下が含まれています：

• すべてのプラットフォーム（Linux、macOS、Windows）向けの事前設定済みIB Gateway

• IB Gateway用のJava Runtime Environment (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"]
    }
  }
}

サーバーを初めて使用する際、Interactive BrokersのOAuth認証フローのためにWebブラウザウィンドウが自動的に開きます。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がトリガーされた場合、ヘッドレス認証は、あなたが設定した方法（モバイルアプリ、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"
      }
    }
  }
}

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

Flex Queryの設定（オプション）

口座明細や履歴データを取得するためにFlex Queryを使用するには、Flex Web Serviceトークンを設定する必要があります：

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

Flexトークンの取得方法:

1. Interactive Brokers口座管理にログインします

2. 設定 → 口座設定 に移動します

3. レポート → Flex Web Service に移動します

4. Flex Web Serviceトークンを生成または取得します

Flex Web Serviceを有効にする詳細な手順については、IB Flex Web Serviceガイドを参照してください。

Flex Queryの作成:

1. 口座管理の レポート → Flex Query に移動します

2. クエリテンプレートを作成またはカスタマイズします

3. クエリの横にある情報アイコンをクリックして、クエリIDを確認します

Flex Queryの作成とカスタマイズに関する完全なガイドについては、IB Flex Queriesガイドを参照してください。

注: Flex Queryを初めて実行すると、MCPサーバーはAPIから取得した名前で自動的に保存します。今後の実行では、IDまたは保存された名前でクエリを参照できます。

Flex Queryの機能:

• 自動メモリ: Flex Queryを実行すると、将来の使用のために自動的に保存されます

• 簡単な再利用: 以前に使用したクエリは記憶されるため、クエリIDを繰り返しコピーする必要はありません

• フレンドリーネーム: クエリを初めて実行する際に、オプションでわかりやすい名前を付けることができます

• クエリの削除: forget_flex_queryツールを使用して、不要になったクエリを削除できます

設定変数

利用可能なMCPツール

取引および口座管理

Flex Query (IB_FLEX_TOKENが必要)

トラブルシューティング

認証の問題:

• 自動的に開くWebインターフェースを使用してください

• 必要な二要素認証をすべて完了してください

• ライブ取引が失敗する場合は、ペーパートレードモードを試してください

サポート

• このサーバー: このリポジトリでIssueを作成してください。

ライセンス

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

貢献者に感謝

このプロジェクトをより良くするために貢献してくださったすべての方々に深く感謝いたします。