trading212-mcp-server

Trading 212 MCP 服务

将你的 AI 助手连接到 Trading 212 券商账户。通过自然语言询问投资组合情况、下单交易、管理饼图并分析股息。

兼容 Claude Desktop、Claude Code、ChatGPT、Gemini、Cursor、Windsurf，以及任何支持 Model Context Protocol (MCP) 的客户端。

为什么选择此服务？

• 32 个工具，涵盖完整的 Trading 212 API，另有 4 个分析工具，可组合多次 API 调用并提供可执行的洞察
• 智能速率限制——读取 T212 的速率限制标头，自动等待，并在遇到 429 时重试（最多 3 次）。速率限制错误不会传递给 AI
• 零配置——从 PyPI 安装，添加 API 密钥即可。无需 Docker、数据库或 Redis
• 类型化响应——每个工具都返回结构化的 Pydantic 模型，而非原始 JSON
• 模拟交易——设置 ENVIRONMENT=demo，先用虚拟资金进行测试

它能做什么？

分析工具

这些工具会将多次 API 调用组合成单个高级响应：

• fetch_portfolio_summary——完整快照：总价值、盈亏、现金、主要持仓和资产配置
• fetch_portfolio_performance——包含股息的逐仓位回报，以及表现最佳和最差的标的
• fetch_dividend_summary——按股票代码和月份分组的收入分析
• fetch_recent_activity——合并交易与资金活动的时间线

快速开始

安装

uvx trading212-mcp-server

或通过 pip 安装：

pip install trading212-mcp-server

获取 API 凭据

在 Trading 212 应用中打开：Settings > API (Beta)。你需要 API Key 和 Secret；此服务使用 Basic Auth。

连接到 Claude Desktop

将以下内容添加到 claude_desktop_config.json（Windows：%APPDATA%\Claude\，Mac：~/Library/Application Support/Claude/）：

{
  "mcpServers": {
    "trading212": {
      "command": "uvx",
      "args": ["trading212-mcp-server"],
      "env": {
        "TRADING212_API_KEY": "<your-api-key>",
        "TRADING212_API_SECRET": "<your-api-secret>",
        "ENVIRONMENT": "live"
      }
    }
  }
}

连接到 Claude Code

claude mcp add trading212 -- uvx trading212-mcp-server

然后在 shell 或 .env 文件中设置环境变量。

其他客户端（Cursor、Windsurf、ChatGPT 等）

使用相同的命令和环境变量，并根据客户端的 MCP 文档进行配置。将 ENVIRONMENT 设置为 demo 即可进行模拟交易。

从源代码安装

git clone https://github.com/KyuRish/trading212-mcp-server.git
cd trading212-mcp-server
cp .env.example .env  # fill in your API keys
uv sync
uv run -m trading212_mcp_server.server

{
  "mcpServers": {
    "trading212": {
      "command": "uv",
      "args": ["run", "--directory", "<path-to-repo>", "-m", "trading212_mcp_server.server"],
      "env": {
        "TRADING212_API_KEY": "<your-api-key>",
        "TRADING212_API_SECRET": "<your-api-secret>",
        "ENVIRONMENT": "live"
      }
    }
  }
}

全部 32 个工具

分析（组合型）

账户

交易

投资组合

市场数据

历史记录

兼容性

已在以下 MCP 客户端中测试：

作者

由 Rishabh Dogra 构建。

支持

如果这个服务为你节省了时间，请我喝杯咖啡，我将不胜感激。

许可证

MIT