交易协议服务器

Trade Republic MCP Server是一个用于访问Trade Republic交易平台的模型上下文协议服务器,支持AI助手交互、投资组合管理及市场数据查询等功能。

  • by j0nl1
  • Rust
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 j0nl1/trade-republic-mcp

使用说明

贸易共和国MCP服务器

A. 模型上下文协议(MCP) 用于访问Trade Republic交易平台的服务器。该服务器使像Claude这样的人工智能助手能够与您的Trade Republic投资组合、市场数据等进行交互。

特性

  • 认证:使用2FA支持进行安全登录
  • 投资组合管理:查看头寸、损益表、现金余额和历史记录
  • 市场数据:实时行情数据、工具详细信息和价格历史
  • 搜索:按名称查找仪器,按类型/管辖区筛选,并发现领先者
  • 债券分析:详细的债券信息,包括到期收益率

安装

来自预构建的二进制文件

从以下网址下载适用于您平台的最新版本 发布页面.

可用二进制文件:

  • x86_64-unknown-linux-musl -Linux(x64,静态链接)
  • aarch64-unknown-linux-musl -Linux(ARM64,静态链接)
  • x86_64-apple-darwin -macOS(英特尔)
  • aarch64-apple-darwin -macOS(苹果硅)
  • x86_64-pc-windows-msvc -Windows(x64)

源自

# Clone the repository
git clone https://github.com/j0nl1/trade-republic-mcp.git
cd trade-republic-mcp

# Build release binary
cargo build --release

# Binary will be at: target/release/trade-republic-mcp

配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "trade-republic": {
      "command": "/path/to/trade-republic-mcp",
      "env": {
        "TR_PHONE_NUMBER": "+49...",
        "TR_PIN": "1234"
      }
    }
  }
}

环境变量

变量 描述
TR_PHONE_NUMBER 您的Trade Republic电话号码(带国家代码)
TR_PIN 您的4位PIN码
RUST_LOG 日志级别(默认值: info)

命令行参数

trade-republic-mcp --phone "+49123456789" --pin "1234"

可用工具

认证

工具 说明
tr_login 使用电话号码和PIN启动登录
tr_verify_2fa 使用2FA代码完成登录
tr_logout 注销并清除会话
tr_status 检查身份验证状态

投资组合

工具 说明
get_portfolio 获取P&L的所有头寸
get_portfolio_history 获取投资组合价值历史记录
get_cash_balance 获取可用现金余额

市场数据

工具 说明
get_ticker 通过ISIN获取实时价格数据
get_instrument_details 获取详细的仪器信息
get_performance_history 获取OHLC价格历史记录

搜索

工具 说明
search_instruments 按名称或关键字搜索
search_with_filters 使用过滤器进行高级搜索
get_top_movers 获得最大赢家/输家
get_bond_details 获取全面的债券信息

用法示例

  1. 首先登录:

    Use tr_login with your phone number and PIN
    
  2. 输入发送到您设备的2FA代码:

    Use tr_verify_2fa with the 4-digit code
    
  3. 访问您的投资组合和市场数据:

    Use get_portfolio to see your positions
    Use get_ticker with an ISIN to get real-time prices
    Use search_instruments to find new investments
    

会话管理

会话存储在 ~/.trade-republic-mcp/session.json 具有受限权限(0600)。服务器在启动时自动加载现有会话,并根据需要刷新它们。

安全

  • 会话令牌以受限的文件权限安全存储
  • 所有登录都需要2FA
  • 不存储凭据;仅会话令牌
  • 所有通信都使用TLS

发展

# Run with debug logging
RUST_LOG=debug cargo run

# Run tests
cargo test

# Check for issues
cargo clippy

许可证

麻省理工学院