项目简介

Trading212 MCP 服务器是一个基于 Model Context Protocol (MCP) 实现的后端服务,旨在将 Trading212 交易平台的功能无缝集成到大型语言模型 (LLM) 应用中。它提供标准化的接口,允许 LLM 访问交易数据、执行交易操作、管理投资组合,并进行金融数据分析。

主要功能点

  • Trading212 API 集成: 全面的账户信息(余额、元数据)、投资组合管理(持仓、派管理)、高级订单处理(市价单、限价单、止损单等)及订单历史查询。
  • 市场数据访问: 获取可交易金融工具信息、交易所工作时间表和历史交易数据,支持实时市场连接。
  • 金融分析工具: 内置专业的金融分析能力,支持货币感知数据处理和风险管理。
  • MCP 协议支持: 完整实现 MCP 协议,通过资源 (Resources)、工具 (Tools) 和提示模板 (Prompts) 提供服务。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/RohanAnandPandit/trading212-mcp-server.git
    cd trading212-mcp-server
  2. 配置环境变量: 复制 '.env.example' 到 '.env' 文件,并编辑 '.env' 文件以配置您的 Trading212 API 密钥和环境。
    cp .env.example .env
    # 在 .env 文件中设置 TRADING212_API_KEY="您的API密钥" 和 ENVIRONMENT="demo" 或 "live"
  3. 安装依赖:
    uv install
    # 或者使用 pip
    # pip install -r requirements.txt

服务器配置(供MCP客户端使用)

要让您的MCP客户端(例如 Claude Desktop)连接到 Trading212 MCP 服务器,您需要将以下配置添加到客户端的 JSON 配置文件中(例如 MacOS 上的 '~/Library/Application Support/Claude/claude_desktop_config.json' 或 Windows 上的 '%APPDATA%/Claude/claude_desktop_config.json')。

请将以下 JSON 代码块添加到客户端配置文件的 'mcpServers' 部分。您需要将 '"/path/to/your/trading212-mcp-server"' 替换为您实际克隆仓库的绝对路径,并将 '"YOUR_TRADING212_API_KEY"' 替换为您的 Trading212 API 密钥。

{
  "mcpServers": {
    "trading212": {
      "command": "uv", // MCP服务器的启动程序,这里使用uv
      "args": [ // 传递给启动程序的参数列表
        "run",
        "--directory",
        "/path/to/your/trading212-mcp-server", // !!! 替换为您的仓库在本地的绝对路径 !!!
        "src/server.py"
      ],
      "env": { // 传递给MCP服务器进程的环境变量
        "TRADING212_API_KEY": "YOUR_TRADING212_API_KEY", // !!! 替换为您的Trading212 API密钥 !!!
        "ENVIRONMENT": "demo" // 根据您的API密钥类型设置,"demo"为模拟账户,"live"为真实账户
      }
    }
  }
}

注意: 如果您的 MCP 客户端支持 Docker,您也可以参考仓库 README 中提供的 Docker 配置方式进行设置。

基本使用方法

配置完成后,您的 MCP 客户端(如 Claude)将能够通过以下方式与 Trading212 MCP 服务器交互:

  • 访问账户资源: 客户端可以请求读取账户元数据、现金余额、持仓和派等信息。例如,获取 'trading212://account/cash'。
  • 调用交易工具: LLM 可以调用服务器提供的工具来执行交易操作,如 'place_market_order' 下市价单,或 'fetch_pies' 获取所有投资派。
  • 使用金融分析提示: LLM 可以利用 'analyse_trading212_data' 提示模板进行金融数据分析,获得专业且货币感知的洞察。

服务器会在后台处理这些请求,并通过 Trading212 API 获取或提交数据。

信息

分类

商业系统