交易数据协议服务器

T212 MCP服务器为Trading 212公共API(v0)提供模型上下文协议服务,使任何MCP兼容客户端能够只读访问您的交易组合、订单、股息等信息。

  • by MohanMV
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 MohanMV/t212-mcp-server

使用说明

T212 MCP服务器

用于交易212公共API(v0)的MCP(模型上下文协议)服务器。为任何兼容MCP的客户端(Claude Desktop等)提供对您的Trading 212投资组合、订单、股息等的只读访问权限。

特性

  • 9个工具,涵盖账户、头寸、订单、股息、交易和元数据
  • 自动处理基于光标的分页
  • 根据T212 API规范的基本身份验证(API密钥+机密)
  • 支持实时和演示环境

先决条件

  • Node.js 18+
  • Trading 212账户(投资或股票ISA——不支持差价合约)
  • T212 API密钥和秘密

设置

1.获取T212 API证书

在Trading 212应用程序中:

  1. 首选 设置→ API
  2. 生成一个新的API密钥-您将获得 API密钥 和 API秘密
  3. 将您的公共IPv4地址列入白名单

2.安装

git clone https://github.com/MohanMV/t212-mcp-server.git
cd t212-mcp-server
npm install

3.在Claude Desktop中配置

打开克劳德桌面→ 设置→ 开发者→ MCP服务器。

添加此配置:

{
  "mcpServers": {
    "t212": {
      "command": "node",
      "args": ["/path/to/t212-mcp-server/index.mjs"],
      "env": {
        "T212_API_KEY": "your_api_key_here",
        "T212_API_SECRET": "your_api_secret_here",
        "T212_ENV": "live"
      }
    }
  }
}

集 "T212_ENV": "demo" 用于纸张交易。

4.验证

问克劳德:

Use the T212 tools to show my portfolio summary.

可用工具

工具 描述 速率限制
get_account 账户摘要:现金、投资、总额、损益 1个需求/5s
get_positions 所有有价格、损益、工具信息的未平仓头寸 1个要求/1s
get_position 按股票代码排列的单个头寸 1个要求/1s
get_portfolio_summary 包含权重、执行者、风险的计算摘要 (2次通话)
get_orders 历史订单(分页,可按股票代码过滤) 6个需求/1m
get_dividends 股息历史记录(分页,可按股票代码过滤) 6个要求/1m
get_transactions 存款、取款等。 6个需求/1米
get_instruments 可交易工具完整列表(大响应) --
get_exchanges 可用交换 --

安全

  • T212 API密钥为 默认情况下为只读 --无法进行交易
  • 凭据保留在您的本地MCP配置中,永远不要离开您的计算机
  • 基本身份验证是base64编码的(未加密)——HTTPS API的标准,其中TLS处理传输中的加密

API注释

  • 仅适用于 投资 和 股票ISA 账户
  • API不支持多个经常账户-以主要货币表示的值
  • 分页使用游标(由服务器自动处理)
  • 费率限制是针对每个帐户的,而不是针对每个密钥的

故障排除

“API密钥无效”或401个错误:

  • 确认你两者都有 T212_API_KEY 和 T212_API_SECRET 集
  • 检查您的IP是否已列入T212应用程序的白名单

“无效的IP地址”:

  • 将您的公共IPv4(非IPv6)列入白名单
  • 没有CIDR符号,只有原始IP

工具未显示在Claude Desktop中:

  • 添加MCP配置后重新启动Claude Desktop
  • 检查路径 args 匹配您的安装位置
  • 跑 node /path/to/index.mjs 直接查看启动错误

许可证

麻省理工学院