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 文件。