交易数据协议服务器

T212MCP是一个用于Trading212 API集成的模型上下文协议服务器,提供对Trading212投资组合数据的只读访问。

  • by sheikhomer
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sheikhomer/T212MCP

使用说明

T212MCP-Trading212模型上下文协议服务器

用于Trading212 API集成的模型上下文协议(MCP)服务器实现,提供对Trading212投资组合数据的只读访问。

工具

  • GetPortfolio:从Trading212获取用户的投资组合。此工具是只读的,不执行任何交易。

先决条件

  • Node.js(v14或更高版本)
  • Trading212 API证书(API密钥和秘密)
  • Docker(可选,用于容器化部署)

安装

  1. 克隆存储库:
git clone https://github.com/yourusername/T212MCP.git
cd T212MCP
  1. 安装依赖项:
npm install
  1. 创建一个 .env 使用Trading212 API凭证在根目录中的文件:
T212_API_KEY=your_api_key
T212_API_SECRET=your_api_secret
T212_API_URL=use_demo_or_live_account_url
PORT=3000

用法

本地运行

启动服务器:

npm start

服务器将在以下时间可用 http://localhost:3000/mcp

使用Docker

使用Docker Compose构建和运行:

docker-compose up --build

API终点

GET/mcp

支持以下工具的主MCP端点:

  • GetPortfolio:获取用户的Trading212投资组合数据
    • 返回包含平均价格、当前价格、数量和损益等详细信息的投资组合项目

环境变量

  • T212_API_KEY:您的Trading212 API密钥
  • T212_API_SECRET:您的Trading212 API秘密
  • T212_API_URL:Trading212 API基础URL(默认为演示环境)
  • PORT:服务器端口(默认为3000)

发展

构建项目:

npm run build

在开发模式下运行:

npm run dev

许可证

这是免费且无阻碍的软件,已发布到公共领域。

任何人都可以自由复制、修改、发布、使用、编译、出售或 以源代码形式或编译后的形式分发此软件 二进制,用于任何目的,商业或非商业,以及任何 意味着。

在承认版权法的司法管辖区,作者 本软件的任何和所有版权权益均归 软件进入公共领域。我们为利益而奉献 对广大公众造成伤害,损害我们的继承人和 继任者。我们打算将这种奉献作为一种公开的行为 永久放弃所有现有和未来的权利 版权法下的软件。

软件按“原样”提供,不提供任何形式的保证, 明示或暗示,包括但不限于以下保证 适销性、适用于特定目的和不侵权。 在任何情况下,作者均不对任何索赔、损害或 其他责任,无论是在合同、侵权或其他诉讼中, 因软件或使用而产生或与之相关的,或 软件中的其他交易。

有关更多信息,请参阅 https://unlicense.org

贡献

欢迎投稿!无论是错误报告、功能建议、代码改进还是文档更新,我们都非常感谢您的帮助。

  • 分叉存储库并创建一个功能或bug修复分支。

  • 确保您的更改与项目目标和编码标准保持一致。

  • 为任何新功能添加清晰的文档/注释。

  • 测试您的更改以确认没有倒退。

  • 提交一个拉取请求,并明确描述更新。

安全

该服务器使用Trading212 API证书实现基本身份验证。确保您的凭据保持安全,永远不要将其提交给版本控制。