Interactive Brokers API FastMCP Server

Interactive Brokers API FastMCP Server

LLM が Model Context Protocol（MCP）を使用して IB アカウントとやり取りできる、Interactive Brokers API のサーバー実装です。

概要

このプロジェクトでは、Interactive Brokers Gateway に接続し、その機能を FastMCP フレームワークを通じて公開するミドルウェアサーバーを作成します。これにより、Claude などの LLM が IB アカウントとやり取りし、ポートフォリオ情報を取得したり、取引を実行したりできるようになります。

機能

• 公式 IB API を介した Interactive Brokers Gateway への接続
• FastMCP による複数の同時クライアント接続のサポート
• IB の機能を MCP ツールおよびリソースとして公開
• 接続ステータスの監視
• エラー処理とログ記録

前提条件

• Python 3.11+
• Interactive Brokers Gateway がインストールされ、実行されていること
• API アクセスが有効な IB アカウント

インストール

1. このリポジトリをクローンします：

git clone https://github.com/karimQuant/ibapi-mcp-server.git
cd ibapi-mcp-server

2. 依存関係をインストールします：

pip install -e .

使用方法

1. IB Gateway を起動してログインします

2. サーバーを実行します：

   a. stdio トランスポートを使用する場合（デフォルト）：

   python server.py
   

   b. SSE トランスポートを使用する場合：

   python server.py sse
   

   c. カスタムポートで SSE トランスポートを使用する場合：

   python server.py sse port=9000
   

   d. FastMCP CLI を使用する場合：

   fastmcp run server.py
   

   e. 対話型テスト環境で開発する場合：

   fastmcp dev server.py
   

3. クライアントアプリケーション（Claude Desktop など）をサーバーに接続します

API ドキュメント

FastMCP サーバーでは、以下の機能を利用できます。

利用可能なツール

• get_portfolio_tool：現在のポートフォリオの保有状況と口座概要を取得します

リソース

• ibgateway://{host}/{port}：IB Gateway 接続の現在のステータスを取得します

ライセンス

MIT

貢献

貢献を歓迎します！お気軽に Pull Request を送信してください。