项目简介
Trading212 MCP 服务器是一个基于 Model Context Protocol (MCP) 实现的后端服务,旨在将 Trading212 交易平台的功能无缝集成到大型语言模型 (LLM) 应用中。它提供标准化的接口,允许 LLM 访问交易数据、执行交易操作、管理投资组合,并进行金融数据分析。
主要功能点
- Trading212 API 集成: 全面的账户信息(余额、元数据)、投资组合管理(持仓、派管理)、高级订单处理(市价单、限价单、止损单等)及订单历史查询。
- 市场数据访问: 获取可交易金融工具信息、交易所工作时间表和历史交易数据,支持实时市场连接。
- 金融分析工具: 内置专业的金融分析能力,支持货币感知数据处理和风险管理。
- MCP 协议支持: 完整实现 MCP 协议,通过资源 (Resources)、工具 (Tools) 和提示模板 (Prompts) 提供服务。
安装步骤
- 克隆仓库:
git clone https://github.com/RohanAnandPandit/trading212-mcp-server.git cd trading212-mcp-server - 配置环境变量: 复制 '.env.example' 到 '.env' 文件,并编辑 '.env' 文件以配置您的 Trading212 API 密钥和环境。
cp .env.example .env # 在 .env 文件中设置 TRADING212_API_KEY="您的API密钥" 和 ENVIRONMENT="demo" 或 "live" - 安装依赖:
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 获取或提交数据。
信息
分类
商业系统