Alexanimal Tradovate MCP Server

🚀 Tradovate MCP 服務器

Tradovate MCP服務器是一個用於與Tradovate API交互的模型上下文協議（MCP）服務器，它提供了管理合約、頭寸、訂單和賬戶的工具，助力開發者高效完成相關操作。

🚀 快速開始

啟動服務器，您可以選擇以下兩種方式：

npm start

或使用MCP Inspector：

npm run inspector

✨ 主要特性

• 身份驗證：支持與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文件。