AI导哈

IBKR投资组合服务

为Interactive Brokers用户提供投资组合数据、市场报价、交易和分析服务的MCP服务器，支持多币种投资组合和欧盟税务分析。

  • by dapdevsoftware
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dapdevsoftware/ibkr-mcp-server

使用说明

ibkr mcp服务器

MCP服务器 盈透证券 --将您的投资组合数据、市场报价、交易和分析暴露给任何兼容MCP的AI客户端。

专为国际/欧盟投资者打造。支持UCITS/PRIIP感知分析、多货币投资组合和爱沙尼亚/欧盟税收环境。

特性

12工具

工具 类型 描述
get_positions read 损益表的当前头寸
get_account_summary read 资产净值、购买力、利润率
get_nav read 快速资产净值检查
get_open_orders read 列出待处理订单
get_quote read 任何符号的实时报价
get_historical_bars 读取 OHLCV条（可配置周期/大小）
search_contracts read 按符号/名称查找IBKR合约
portfolio_snapshot read 带有重量和浓度警告的完整分析
concentration_check read 标记超过权重阈值的位置
transition_plan read 计算目标分配的卖出/买入计划
place_order 写 下限价单（安全门）
cancel_order 写 取消未结订单（安全门）

所有阅读工具均附有注释 readOnlyHint=True.书写工具的注释为 destructiveHint=True 并要求 SAFETY_PAPER_ONLY=false.

4资源

URI 描述
ibkr://positions 实时职位列表
ibkr://account/summary 账户摘要
ibkr://orders/open 未结订单
ibkr://portfolio/snapshot 完整的投资组合分析

4提示

提示 描述
portfolio-review 分析投资组合的风险和机遇
rebalance-plan 制定一个朝向目标分配的再平衡计划
risk-check 检查浓度风险和暴露
tax-analysis 分析税收影响（欧盟/爱沙尼亚背景）

先决条件

  • IB网关 正在运行（通过Docker或独立运行）
  • Python 3.12+ 随着 紫外线
  • IBKR帐户 启用API访问

通过Docker实现IB网关

docker run -d \
  --name ib-gateway \
  -p 4003:4003 \
  -p 5900:5900 \
  -e TWS_USERID=your_username \
  -e TWS_PASSWORD=your_password \
  -e TRADING_MODE=live \
  -e TWS_PORT=4003 \
  ghcr.io/gnzsnz/ib-gateway:stable

启动后，批准IBKR Mobile上的2FA提示。

安装

git clone https://github.com/deividi86/ibkr-mcp-server.git
cd ibkr-mcp-server
cp .env.example .env
# Edit .env with your gateway host/port
uv sync

在Claude代码中配置

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "ibkr": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ibkr-mcp-server", "ibkr-mcp"]
    }
  }
}

在Claude桌面中配置

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "ibkr": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ibkr-mcp-server", "ibkr-mcp"]
    }
  }
}

用法

配置后，询问您的AI客户端以下问题：

  • “我目前的职位是什么？”
  • “分析我的投资组合风险”
  • “制定一个再平衡计划，实现70%的VWCE、20%的AGGG、10%的IBC1”
  • “获取VWCE的报价”
  • “寻找先锋UCITS ETF”

安全

默认情况下，交易被禁用。这 SAFETY_PAPER_ONLY=true 环境变量块 place_order 和 cancel_order。所有只读工具都可以正常工作。

要启用实时交易：

SAFETY_PAPER_ONLY=false

即使启用了交易，只有 限价订单 支持-没有市价订单。

环境变量

变量 默认值 描述
IB_GATEWAY_HOST 127.0.0.1 IB网关主机
IB_GATEWAY_PORT 4003 IB网关端口
IB_ACCOUNT （空） 帐户ID（可选，使用第一个托管帐户）
SAFETY_PAPER_ONLY true 为真时阻止交易工具

发展

uv sync --dev
uv run pytest -v

许可证

麻省理工学院

相关 MCP