tradingprogpt

Servidor MCP de solo lectura sobre MetaTrader 5 y Twelve Data, con una capa de análisis basada en LLM.

El servidor expone datos de mercado como herramientas MCP. No ejecuta órdenes ni tiene forma de hacerlo: el módulo de MT5 no importa order_send ni ninguna función de ejecución.

Fuentes de datos

Fuente	Qué aporta
MetaTrader 5	Tus posiciones abiertas, tu balance, el spread real que te cobra tu bróker, velas de tu feed
Twelve Data	Datos institucionales limpios: acciones, forex, cripto, indicadores técnicos

No compiten. MT5 sabe cosas que solo tu bróker sabe; Twelve Data da cobertura y calidad de datos que MT5 no tiene.

Requisitos

• Windows. La librería MetaTrader5 de Python es Windows-only.
• Python 3.11+
• Terminal MT5 abierta y con sesión iniciada. La librería se acopla a una terminal existente; no la lanza ni se loguea sola.
• API key de Twelve Data
• API key de OpenAI

Instalación

uv sync
cp .env.example .env   # luego edita .env con tus keys reales

El archivo .env está en .gitignore y nunca debe subirse al repo.

Uso

Arranca el servidor MCP:

uv run tradingprogpt-mcp

Para conectarlo a Claude Code:

claude mcp add tradingprogpt -- uv --directory /ruta/a/tradingprogpt run tradingprogpt-mcp

Herramientas expuestas

MetaTrader 5

• mt5_account_summary — balance, equity, margen, y si la cuenta es real o demo
• mt5_candles — velas OHLCV del feed del bróker
• mt5_positions — posiciones abiertas con profit no realizado
• mt5_symbol_info — bid/ask, spread, tamaño de contrato
• mt5_list_symbols — símbolos disponibles

Twelve Data

• td_quote — cotización actual
• td_candles — serie temporal OHLCV
• td_indicator — RSI, MACD, EMA, Bollinger, ATR, ADX…

Problemas comunes

IPC timeout (-10005) al conectar con MT5. Es el error más frecuente y casi nunca es un bug del código. Significa que la terminal no está abierta, o está abierta pero sin sesión iniciada en una cuenta. Abre MT5, inicia sesión, y déjala corriendo.

Seguridad

El proyecto es de solo lectura por diseño. Si algún día se habilita ejecución de órdenes, debe hacerse en un módulo aparte, empezando por cuenta demo, y con confirmación explícita antes de cada orden. Nunca ampliando sources/mt5.py.