rcontesti/ib_mcp

[!注]

プロジェクトの状況

このプロジェクトは現在活発に開発中です。機能が未完成の場合や、壊れた変更が発生する場合があります。

動機

このプロジェクトはInteractive Brokers Web APIのみを基に構築されており、これは意図的な設計選択です。TWS APIは強力ですが、Web APIはこのプロジェクトの目標に対してより現代的で柔軟な基盤を提供します。

TWS API MCPとWEB API MCP、どちらがいい?

なぜTWS APIを使わないのか? 簡単に言うと、WEB APIはより包括的なものになる予定です。より包括的というのは、アカウント管理、特にレポート作成を同じ場所にまとめるという意味です。他に2つの重要な理由は、1. Web APIはスタンドアロンである。TWSデスクトップソフトウェアやIBゲートウェイを実行する必要がない。2. モデルコンテキストプロトコル(MCP)はTCP/IPソケットよりもHTTPS通信の上に構築しやすい。

より包括的ななら、なぜWEB APIだけを使わないのか? 理由は3つあります。1. WEB APIはベータ版(制限参照)。2. TWSは取引においてより高速で信頼性が高い。3. TWSにはWEB APIにはない取引機能がある。

[!Note]

Project Status

This project is currently under active development. Features may be incomplete, and breaking changes may occur.

Motivation

This project is built exclusively on the Interactive Brokers Web API, and this is a deliberate design choice. While the TWS API is powerful, the Web API provides a more modern and flexible foundation for the goals of this project.

TWS API MCP vs. WEB API MCP?

Why not using the TWS API? The short answer is that the WEB API is planned to be more comprehensive. By more comprehensive I mean, it brings account management, specifically reporting, into the same place. The two other important reasons are: 1. The Web API is standalone. It does not require you to run the TWS desktop software or IB Gateway. 2. Model context protocols (MCPs) are easier to build on top of HTTPS communication rather than TCP/IP sockets.

If it is more comprehensive why not using just the WEB API? Three reasons: 1. WEB API is in beta (see Limitations) 2. TWS is faster and more reliable for trading. 3. TWS has some trading functionalities that the WEB API does not have.

While other projects act as a “bridge” to make the TWS API look like a web API, they introduce an unofficial, third-party dependency. This project avoids that risk by using the official IBKR Web API directly, ensuring better long-term stability and support.

In summary:

• If you need fast and reliable trading go with TWS API
• If you need a more comprehensive and cloud ready solution go with the WEB API

For a more detailed, side-by-side breakdown, please see the TWS vs. Web API Comparison section.

Table of Contents

• Table of Contents
• Overview
• Docker Desktop Setup
  • Limitations of Multi-Container Setup
  • Session Management
• Future Work
• Endpoints Status
• TWS vs WEB comparison
• Limitations
• Architecture
  • 📦 Interactive Brokers Client Portal Gateway Docker Container
    • 🔧 What This Container Does
  • 📦 Interactive Brokers Routers Generator Docker Container [WIP]
  • 📦 IB MCP Server Docker Container
    • 🔧 What This Container Does
• References