🚀 Tradovate MCP 服务器
Tradovate MCP 服务器是一个用于与 Tradovate API 交互的模型上下文协议（MCP）服务器，它提供了管理合约、头寸、订单和账户的工具，能帮助用户高效地与 Tradovate 平台进行交互。
🚀 快速开始
首先，你需要克隆仓库并安装依赖，同时配置好 .env 文件。完成后，即可启动服务器开始使用。
克隆仓库
git clone https://github.com/alexanimal/tradovate-mcp-server.git
cd tradovate-mcp-server
安装依赖
npm install
配置 .env 文件
创建一个 .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
✨ 主要特性
- 支持与 Tradovate API 的身份验证，确保数据交互的安全性。
- 具备带有缓存的实时数据获取功能，提高数据获取效率。
- 提供合约详细信息、头寸管理、订单放置、修改等工具，满足多样化的交易需求。
- 在 API 不可用时，可 fallback 到模拟数据，保证服务的稳定性。
📦 安装指南
- 克隆仓库
git clone https://github.com/alexanimal/tradovate-mcp-server.git
cd tradovate-mcp-server
- 安装依赖
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/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/get：获取市场深度/md/getChart：获取图表数据
📄 许可证
本项目采用 MIT License。
