Trade Republic MCP Server

贸易共和国MCP服务器

一种模型上下文协议（MCP）服务器，提供与Trade Republic交互的工具。 该存储库包括MCP服务器和用于自主交易的Claude Skill。

通过这个项目，像克劳德这样的人工智能助手可以检查账户余额，查看市场数据，并通过内置的自主交易代理执行交易。

______________________________________________________________________

⚠️ 重要免责声明⚠️

非官方API-使用风险自负

Trade Republic不提供公共API。 该项目基于社区研究（例如。， 派特尔).

使用此软件可能会违反Trade Republic的服务条款。 - 您的帐户可能会被暂停或终止 - 贸易共和国可随时更改其API，恕不另行通知 - 没有官方支持或文件 - API行为基于社区观察，而非官方规范

仅用于教育目的

本项目仅用于教育目的。 它表明：

• 如何为AI助手构建MCP服务器
• WebSocket通信模式
• ECDSA身份验证流程

在不了解风险的情况下，不要将此软件用于实际交易。

真钱警告

如果您选择使用具有有效凭据的此软件，它将在您的Trade Republic帐户上执行真实交易。您的实际资金可以买入、卖出或损失。

永远不要用你无法承受损失的资金使用这个软件。 - 作者对经济损失不承担任何责任 - 作者对账户暂停不承担任何责任 - 自动交易本身就有风险 - 过去的表现并不能保证未来的结果

______________________________________________________________________

特性

MCP工具

通过MCP工具访问Trade Republic功能：

• 投资组合：获取投资组合头寸、现金余额
• 市场数据：获取价格、价格历史、订单簿、搜索资产
• 资产信息：获取详细的仪器信息
• 市场现状：检查市场是否开放
• 订单：下单、修改、取消订单（即将推出）

自主交易代理（即将推出）

Claude Skill运行一个自主交易机器人，具有：

• 技术分析
• 风险管理
• 自动订单执行

______________________________________________________________________

入门指南

先决条件

• Node.js 18+
• 贸易共和国账户
• Claude 代码命令行界面

1.克隆和设置

git clone https://github.com/your-username/trade-republic-bot
cd trade-republic-bot
npm install

2.建造

npm run build

3.配置Claude

将MCP服务器添加到您的Claude设置中：

{
  "mcpServers": {
    "trade-republic": {
      "url": "http://localhost:3006/mcp"
    }
  }
}

4.启动服务器

npm start

5.身份验证

服务器需要Trade Republic凭据。您需要完成身份验证流程，其中包括：

1. 电话号码
2. 个人识别码
3. 2FA代码（通过短信或应用程序发送）

______________________________________________________________________

发展

项目结构

trade-republic-bot/
├── src/
│   ├── index.ts                      # Entry point
│   ├── logger.ts                     # Logging utilities
│   └── server/
│       ├── TradeRepublicMcpServer.ts # MCP server
│       ├── services/                 # API services
│       │   ├── TradeRepublicApiService.ts
│       │   ├── PortfolioService.ts
│       │   └── MarketDataService.ts
│       └── tools/                    # MCP tool registries
│           ├── PortfolioToolRegistry.ts
│           └── MarketDataToolRegistry.ts
├── docs/
│   ├── adr/                          # Architecture Decision Records
│   └── plans/                        # Implementation plans
└── package.json

脚本

npm start           # Start production server
npm run build       # Build TypeScript
npm test            # Run tests
npm run test:coverage # Run tests with coverage
npm run lint        # Check code style
npm run lint:fix    # Fix code style issues
npm run format      # Format code with Prettier
npm run knip        # Check for unused exports

代码质量

该项目遵循严格的质量标准：

• 100%测试覆盖率 必需的
• 埃斯林特 + 更漂亮 实现一致的代码风格
• 约定式提交 为了清晰的历史
• 黄道带 用于运行时验证

______________________________________________________________________

安全

1. 从不提交凭据 -使用环境变量
2. 监控您的帐户 -检查Trade Republic是否有意外活动
3. 从小事做起 -如果使用真实资金进行测试，请使用最低金额
4. 了解风险 -这是非官方软件

______________________________________________________________________

故障排除

______________________________________________________________________

法律

无隶属关系

本项目与Trade Republic Bank GmbH没有任何关联、背书或联系。

无保修

本软件按“原样”提供，不提供任何形式的保修。使用风险自负。

许可证

麻省理工学院

______________________________________________________________________

资源

• 模型上下文协议
• 派特尔 -Python Trade Republic API客户端（社区研究）
• 克劳德代码

______________________________________________________________________

贡献

欢迎捐款，但请注意：

1. 这是一个教育项目
2. 我们无法保证与Trade Republic的API兼容
3. 所有贡献必须包括测试
4. 遵循现有代码样式