Tradovate MCP Server

Tradovate MCP 服务

用于与 Tradovate API 交互的模型上下文协议（MCP）服务。此服务提供用于管理 Tradovate 中的合约、持仓、订单和账户的工具。

功能

• 使用 Tradovate API 进行身份验证
• 实时数据获取与缓存
• 提供合约详情、持仓管理、下单等工具
• API 不可用时回退到模拟数据

安装

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

npm install

3. 使用 Tradovate 凭据创建 .env 文件：

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 - 获取市场数据（报价、DOM、图表）

API 端点

该服务会与以下 Tradovate API 端点交互：

身份验证

• /auth/accessTokenRequest - 获取访问令牌
• /auth/renewAccessToken - 续期访问令牌

合约

• /contract/list - 列出所有合约
• /contract/find - 查找特定合约

持仓

• /position/list - 列出所有持仓

订单

• /order/list - 列出所有订单
• /order/placeOrder - 下新订单
• /order/modifyOrder - 修改现有订单
• /order/cancelOrder - 取消现有订单
• /order/liquidatePosition - 平仓

账户

• /account/list - 列出所有账户
• /account/find - 查找特定账户
• /cashBalance/getCashBalanceSnapshot - 获取账户的现金余额

市场数据

• /md/getQuote - 获取报价数据
• /md/getDOM - 获取市场深度数据
• /md/getChart - 获取图表数据

许可证

MIT 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。