返回 MCP 目录
public公开dns本地运行

ibkr-mcp-server

一个基于FastAPI的应用,用于通过IBKR API获取投资组合详情

article

README

🚀 IBKR MCP 服务器

本项目是一个基于 FastAPI 的应用程序,通过与 Interactive Brokers (IBKR) API 对接,能够便捷地获取投资组合详情,为投资管理提供有力支持。

🚀 快速开始

本项目是一个基于 FastAPI 的应用程序,通过与 Interactive Brokers (IBKR) API 对接,能够便捷地获取投资组合详情,为投资管理提供有力支持。

✨ 主要特性

  • 基于 FastAPI 构建,具备高性能和良好的可扩展性。
  • 与 Interactive Brokers (IBKR) API 对接,可获取投资组合详情。

📦 安装指南

  1. 克隆仓库
    git clone <repository-url>
    cd ibkr-mcp-server
    
  2. 创建虚拟环境
    python -m venv venv
    source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
    
  3. 安装依赖项
    pip install -r requirements.txt
    
  4. 设置环境变量: 创建根目录中的 .env 文件,并添加您的 IBKR API 凭证。
  5. 运行应用程序
    uvicorn app.main:app --reload
    

💻 使用示例

基础用法

一旦服务器启动,您可以通过访问 API 端点来获取投资组合详情。API 文档将在 http://localhost:8000/docs 可用。

📚 详细文档

项目结构

ibkr-mcp-server
├── app
│   ├── __init__.py
│   ├── main.py
│   ├── api
│   │   ├── __init__.py
│   │   └── endpoints
│   │       ├── __init__.py
│   │       └── portfolio.py
│   ├── core
│   │   ├── __init__.py
│   │   └── config.py
│   ├── models
│   │   ├── __init__.py
│   │   └── portfolio.py
│   └── services
│       ├── __init__.py
│       └── ibkr_service.py
├── requirements.txt
├── .env
└── README.md

📄 许可证

该项目在 MIT License 下开源。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端