Servidor Tradovate MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Tradovate. Este servidor proporciona herramientas para gestionar contratos, posiciones, pedidos y cuentas en Tradovate.

Características

• Autenticación con la API de Tradovate

• Obtención de datos en tiempo real con almacenamiento en caché

• Herramientas para detalles de contratos, gestión de posiciones, colocación de pedidos y más

• Recurrir a datos simulados cuando la API no está disponible

Related MCP server: Alpaca Trading MCP Server

Instalación

1. Clonar el repositorio

2. Instalar dependencias:

npm install

3. Cree un archivo .env con sus credenciales de 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

Uso

Iniciar el servidor:

npm start

O úselo con el Inspector MCP:

npm run inspector

Desarrollo

Estructura del proyecto

• src/index.ts - Punto de entrada del servidor principal

• src/auth.ts - Funciones de autenticación

• src/data.ts - Obtención y almacenamiento en caché de datos

• src/tools.ts - Controladores de herramientas para MCP

• src/types.ts - Definiciones de tipos de TypeScript

• tests/ - Archivos de prueba

Edificio

npm run build

Pruebas

Ejecutar pruebas:

npm test

Ejecutar pruebas con cobertura:

npm run test:coverage

Generar insignia de cobertura:

npm run coverage:badge

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

1. get_contract_details - Obtener detalles de un contrato específico por símbolo

2. list_positions - Lista de posiciones para una cuenta

3. place_order - Realizar un nuevo pedido

4. modify_order - Modificar un pedido existente

5. cancel_order - Cancelar un pedido existente

6. liquidate_position - Liquidar una posición

7. get_account_summary - Obtener información resumida de la cuenta

8. get_market_data - Obtener datos del mercado (cotizaciones, DOM, gráficos)

Puntos finales de API

El servidor interactúa con los siguientes puntos finales de la API de Tradovate:

Autenticación

• /auth/accessTokenRequest - Obtener el token de acceso

• /auth/renewAccessToken - Renovar el token de acceso

Contratos

• /contract/list - Lista todos los contratos

• /contract/find - Encuentra un contrato específico

Posiciones

• /position/list - Lista todas las posiciones

Pedidos

• /order/list - Lista todos los pedidos

• /order/placeOrder - Realizar un nuevo pedido

• /order/modifyOrder - Modificar un pedido existente

• /order/cancelOrder - Cancelar un pedido existente

• /order/liquidatePosition - Liquidar una posición

Cuentas

• /account/list - Lista todas las cuentas

• /account/find - Encuentra una cuenta específica

• /cashBalance/getCashBalanceSnapshot - Obtener el saldo en efectivo de una cuenta

Datos de mercado

• /md/getQuote - Obtener datos de cotización

• /md/getDOM - Obtener la profundidad de los datos del mercado

• /md/getChart - Obtener datos del gráfico

Licencia

Licencia MIT

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.