🚀 Tradovate MCP 服务器

Tradovate MCP服务器是一个用于与Tradovate API交互的模型上下文协议（MCP）服务器，它提供了管理合约、头寸、订单和账户的工具，助力开发者高效完成相关操作。

🚀 快速开始

启动服务器，您可以选择以下两种方式：

npm start

或使用MCP Inspector：

npm run inspector

✨ 主要特性

• 身份验证：支持与Tradovate API进行身份验证。
• 实时数据获取：可实时获取数据，并带有缓存功能。
• 多功能工具：提供合约详情、头寸管理、订单下单等多种工具。
• 备用方案：当API不可用时，提供模拟数据作为备用。

📦 安装指南

1. 克隆仓库。
2. 安装依赖：

npm install

3. 创建一个.env文件，并添加您的Tradovate凭证：

TRADOVATE_API_ENVIRONMENT=demo
TRADOVATE_USERNAME=your_username
TRADOVATE_PASSWORD=your_password
TRADOVATE_APP_ID=Sample App
TRADOVATE_APP_VERSION=1.0
TRADOVATE_CID=your_cid
TRADOVATE_SEC=your_sec

💻 使用示例

基础用法

启动服务器：

npm start

高级用法

使用MCP Inspector：

npm run inspector

📚 详细文档

项目结构

• src/index.ts - 服务器主入口文件
• src/auth.ts - 身份验证功能
• src/data.ts - 数据获取与缓存
• src/tools.ts - MCP工具处理程序
• src/types.ts - TypeScript类型定义
• tests/ - 测试文件

构建过程

npm run build

测试方法

运行测试：

npm test

带覆盖的测试：

npm run test:coverage

生成覆盖率徽章：

npm run coverage:badge

可用工具

该服务器提供的工具包括：

1. get_contract_details - 获取特定合约的详细信息（按符号）
2. list_positions - 列出账户中的头寸
3. place_order - 下达新订单
4. modify_order - 修改现有订单
5. cancel_order - 撤销现有订单
6. liquidate_position - 平仓处理
7. get_account_summary - 获取账户摘要信息
8. get_market_data - 获取市场数据（行情、深度图表）

API端点

该服务器与Tradovate API交互的端点包括：

身份验证

• /auth/accessToken - 获取访问令牌
• /auth/refreshToken - 刷新访问令牌

合约相关

• /contracts - 获取所有合约信息
• /contracts/{id} - 获取特定合约的详细信息

头寸管理

• /positions - 列出所有头寸
• /positions/{id} - 获取特定头寸的信息

订单处理

• /orders - 下达新订单或列出所有订单
• /orders/{id} - 获取或取消特定订单
• /orderBook - 获取订单簿信息

账户相关

• /accounts - 列出所有账户信息
• /balances - 查询资金余额
• /transfers - 处理资金划转

市场数据

• /quotes - 获取实时行情数据
• /candles - 获取历史K线数据
• /marketDEPTH - 查看市场深度

📄 许可证

该项目采用MIT许可证，具体内容请参考LICENSE文件。