iflow-mcp_gaochx_ibkr-mcp-server

# IBKR MCP Server An Interactive Brokers (IBKR) MCP server implementation based on FastMCP 2.0 and MCP StreamableHTTP, providing account management, trading operations, and market data query functionality. ## Features - 🔗 **Connection Management**: Stable connection with IBKR TWS/Gateway - 📊 **Account Information**: Query account summary, positions, and balances - 💹 **Trading Operations**: Place orders, cancel orders, query order status - 📈 **Market Data**: Real-time and historical market data retrieval - 🛡️ **Type Safety**: Data validation using Pydantic - ⚡ **Async Architecture**: High-performance asynchronous I/O operations - 📝 **Rich Logging**: Structured logging - 🔧 **Flexible Configuration**: Support for environment variables and configuration files ## Installation ### Install from Source ```bash git clone https://github.com/yourusername/ibkr-mcp-server.git cd ibkr-mcp-server # Create virtual environment python3 -m venv venv source venv/bin/activate # Install the package pip install -e . ``` ### Development Setup ```bash # Install development dependencies pip install -e ".[dev]" # Setup pre-commit hooks pre-commit install ``` ## Quick Start ### 1. Configure Environment Create a `.env` file in the project root: ```env # MCP Server Settings MCP__HOST=0.0.0.0 MCP__PORT=8080 # IBKR Connection Settings IBKR__HOST=127.0.0.1 IBKR__PORT=4002 IBKR__CLIENT_ID=1 IBKR__READONLY=false # Logging Settings LOGGING__LEVEL=INFO ``` ### 2. Test Connection ```bash # Test IBKR connection python -m ibkr_mcp_server.cli test --host 127.0.0.1 --port 4002 ``` ### 3. Start Server ```bash # Start server python -m ibkr_mcp_server.cli serve # Or with custom parameters python -m ibkr_mcp_server.cli serve --host 0.0.0.0 --port 8080 ``` ## Configuration ### Environment Variables | Variable | Default | Description | |----------|---------|-------------| | `MCP__HOST` | `0.0.0.0` | MCP server listen address | | `MCP__PORT` | `8080` | MCP server port | | `IBKR__HO…