🚀 Tradovate MCP 服务器
这是一个用于与Tradovate API交互的模型上下文协议（MCP）服务器，它提供了一系列工具，可用于管理合约、头寸、订单和账户，为用户与Tradovate API的交互提供了便利。
🚀 快速开始
要开始使用本服务器，您需要完成安装步骤，然后启动服务器。以下是详细的操作步骤。
✨ 主要特性
- 身份验证：支持与Tradovate API进行身份验证。
- 实时数据获取：能够实时获取数据，并带有缓存功能，提高数据获取效率。
- 丰富的工具集：提供合约详情、头寸管理、订单下单等多种工具。
- 备用数据支持：当API不可用时，提供模拟数据作为备用，确保服务的稳定性。
📦 安装指南
- 克隆仓库。
- 安装依赖：
npm install
- 创建一个
.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
可用工具
该服务器提供的工具包括：
get_contract_details- 获取特定合约的详细信息（按符号）list_positions- 列出账户中的头寸place_order- 下达新订单modify_order- 修改现有订单cancel_order- 撤销现有订单liquidate_position- 平仓处理get_account_summary- 获取账户摘要信息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文件。