AI导哈

交易212 MCP服务器

连接AI助手到Trading 212经纪账户，通过自然语言查询投资组合、下单交易、管理派息分析等。

  • by KyuRish
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 KyuRish/trading212-mcp-server

使用说明

交易212 MCP服务器

将您的AI助手连接到您的Trading 212经纪账户。通过自然语言询问有关您的投资组合、进行交易、管理馅饼和分析股息的问题。

适用于 克劳德桌面、克劳德代码、ChatGPT、Gemini、光标、Windsurf，以及任何支持 模型上下文协议（MCP）.

为什么是这个服务器？

  • 32工具 涵盖完整的Trading 212 API，加上4个分析工具，将多个API调用合并为可操作的见解
  • 智能限速 -读取T212的速率限制标头，自动等待，并在429上重试（最多3次）。没有速率限制错误泄漏到您的AI
  • 零配置 -从PyPI安装，添加您的API密钥，完成。没有Docker，没有数据库，没有Redis
  • 打字回复 -每个工具都返回结构化的Pydantic模型，而不是原始JSON
  • 纸上交易 -set ENVIRONMENT=demo 先用虚拟货币测试

它能做什么？

类别 工具 示例
分析 投资组合摘要、业绩、股息、活动 “显示我的投资组合损益”
交易 市价、限价、止损、止损限价单 “买入5股AAPL”
投资组合 头寸、现金余额、账户信息 “我的现金余额是多少？”
馅饼 创建、更新、复制、删除馅饼 “显示我的馅饼分配”
市场数据 仪器搜索、更换时间表 “搜索特斯拉”
历史 过去的订单、股息、交易、CSV导出 “显示我的股息历史记录”

分析工具

这些将多个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应用程序： 设置>API（测试版）.您需要API密钥和密钥-服务器使用基本身份验证。

连接到克劳德桌面

添加 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 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
claude_desktop_config.json for source installs 
{
  "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个工具

分析（综合）

工具 说明
fetch_portfolio_summary 完整的投资组合快照，包括损益和分配
fetch_portfolio_performance 按头寸回报、股息、最佳/最差表现
fetch_dividend_summary 按股票代码和月份划分的股息收入
fetch_recent_activity 交易和交易的合并时间表

账户

工具 说明
fetch_account_info 账户元数据（货币、ID）
fetch_account_cash 现金余额、投资价值、损益
fetch_all_open_positions 所有具有实时价格的投资组合头寸
search_specific_position_by_ticker 按股票代码查找单个位置

交易

工具 说明
place_market_order 按当前市场价格买入/卖出
place_limit_order 以指定价格或更高价格买入/卖出
place_stop_order 以止损价触发订单
place_stop_limit_order 使用限制执行停止触发器
fetch_all_orders 列出所有待处理订单
fetch_order 按ID获取特定订单
cancel_order 取消待处理订单

馅饼

工具 说明
fetch_pies 列出所有投资项目
fetch_a_pie 饼图细节与仪器分配
create_pie 创建具有目标权重的新饼图
update_pie 更新饼图设置和分配
duplicate_pie 克隆现有饼图
delete_pie 移除馅饼

市场数据

工具 说明
search_instrument 按股票代码或名称搜索可交易工具
search_exchange 搜索可用的交易所

历史

工具 说明
fetch_historical_order_data 带分页的过去订单
fetch_paid_out_dividends 股息支付历史
fetch_transaction_list 存款和取款
fetch_exports_list 列出CSV导出报告
request_csv_export 请求新的CSV导出

兼容性

使用这些MCP客户端进行了测试：

客户端 状态
克劳德桌面 支持
克劳德代码 支持
光标 支持
Windsurf 支持
任何兼容MCP的客户端 支持

作者

由...建造 里沙布·多格拉.

支持

如果这台服务器能节省你的时间，一杯咖啡就意味着很多。

许可证

麻省理工学院

相关 MCP