Alexanimal Tradovate MCP Server

🚀 Tradovate MCP 服务器

这是一个用于与Tradovate API交互的模型上下文协议（MCP）服务器，它提供了一系列工具，可用于管理合约、头寸、订单和账户，为用户与Tradovate API的交互提供了便利。

🚀 快速开始

要开始使用本服务器，您需要完成安装步骤，然后启动服务器。以下是详细的操作步骤。

✨ 主要特性

• 身份验证：支持与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文件。