Skip to main content
Glama
enesjakoruzh
masdevid

MT5-Quant

by masdevid
OverviewSchemaRelated ServersScoreDiscussions
Rust
Local

MT5-Quant

OpenSSF Scorecard CII Best Practices Rust CI crates.io License: MIT CodeQL

Servidor MCP para el desarrollo de estrategias MT5 en macOS/Linux. 89 herramientas para compilar, ejecutar backtests, analizar, optimizar, depurar fallos y gestionar asesores expertos MQL5 — sin necesidad de Windows.

You: "Backtest MyEA Jan-Mar, what caused the February drawdown?"

Claude: [compile → clean → backtest → analyze 1,847 deals]
        → Feb 14: BUY grid at L6, locking lot 1.75× base
        → Cutloss fired 17 points later
        → Recommendation: cap locking multiplier to ≤1.2×

Por qué MT5-Quant

Enfoque: organización de backtests, informes y analíticas: capacidades que el propio MT5 no ofrece.

MT5-Quant

Otros

Plataforma

Nativo para macOS/Linux

Solo Windows

Proceso de backtest

✅ Completo (compilar → ejecutar → analizar)

✅ Mediante el paquete Python de MT5

Analíticas a nivel de operación

✅ 19 dimensiones, respaldado por BD

❌

Organización de informes

✅ SQLite (informes + operaciones) + búsqueda + historial

❌

Compilación MQL5

✅ Sin interfaz (MetaEditor mediante Wine, sin GUI)

⚠️ Mediante GUI o terminal

Optimización

✅ En segundo plano + análisis de resultados + generación de .set

⚠️ Solo terminal, sin análisis

Depuración de fallos

✅ Diagnósticos de Wine/MT5

❌

Otros suelen ejecutarse en Windows mediante el MetaTrader5 Python package, que ofrece operaciones completas del terminal. MT5-Quant cubre ese vacío: organizar informes de backtest, extraer información a nivel de operación y gestionar flujos de trabajo de optimización, algo que ni MT5 ni su API de Python exponen de forma nativa.

Related MCP server: mt4ctl

Inicio rápido

Instalar MT5-Quant

Opción A — Cargo (recomendada, requiere cadena de herramientas de Rust)

cargo install mt5-quant --locked

Opción B — Binarios precompilados (sin cadena de herramientas)

# macOS Apple Silicon
curl -LO https://github.com/masdevid/mt5-quant/releases/latest/download/mcp-mt5-quant-macos-arm64.tar.gz
tar xzf mcp-mt5-quant-macos-arm64.tar.gz   # → mcp-mt5-quant-macos/mt5-quant

# Linux x64
curl -LO https://github.com/masdevid/mt5-quant/releases/latest/download/mcp-mt5-quant-linux-x64.tar.gz
tar xzf mcp-mt5-quant-linux-x64.tar.gz     # → mcp-mt5-quant-linux/mt5-quant

Coloca el binario en algún lugar de tu PATH (p. ej. /usr/local/bin o ~/.local/bin) para que los clientes puedan ejecutarlo como mt5-quant.

Opción C — Regístralo con tu cliente LLM (copiar y pegar)

Claude Code

claude mcp add mt5-quant -- mt5-quant --stdio

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "mt5-quant": { "command": "mt5-quant", "args": ["--stdio"] } } }

Cursor — .cursor/mcp.json (misma estructura JSON que Claude Desktop)

{ "mcpServers": { "mt5-quant": { "command": "mt5-quant", "args": ["--stdio"] } } }

opencode — .opencode/opencode.jsonc

{ "mcp": { "mt5-quant": { "type": "local", "command": ["mt5-quant", "--stdio"], "enabled": true } } }

Codex CLI — ~/.codex/config.toml

[mcp_servers.mt5-quant]
command = "mt5-quant"
args = ["--stdio"]

Luego completa la configuración (detecta automáticamente las rutas de Wine y MT5):

bash scripts/setup.sh

Consejo: también puedes simplemente pedirle a tu agente de codificación LLM que haga todo lo anterior: "Por favor, instala mt5-quant desde https://github.com/masdevid/mt5-quant — descárgalo o compílalo, ejecuta su scripts/setup.sh para detectar automáticamente las rutas de Wine y MT5, y regístralo como servidor MCP."

Primer backtest

Run a backtest on MyEA from 2025.01.01 to 2025.03.31

La IA ejecuta el proceso completo: compilar → limpiar caché → backtest → extraer → analizar.

Herramientas MCP (89)

Flujo de trabajo principal

Herramienta

Descripción

run_backtest

Proceso completo: compilar → limpiar → backtest → extraer → analizar

run_backtest_quick

Backtest rápido usando un EA precompilado (omite la compilación)

run_backtest_only

Solo backtest: extrae las operaciones brutas, sin análisis

launch_backtest

Lanzar y olvidar: inicia el backtest de MT5 y consulta hasta que termine

get_backtest_status

Consulta el estado del backtest en ejecución (MT5 en ejecución, informe encontrado, tiempo transcurrido)

run_optimization

Optimización genética (en segundo plano, devuelve el control de inmediato)

get_optimization_results

Analiza los resultados de la optimización cuando MT5 termina

list_jobs

Lista todos los trabajos de optimización con su estado

analyze_report

Lee analysis.json de cualquier directorio de informes

compare_baseline

Compara el informe con la línea base y devuelve un veredicto de ganador/perdedor

compile_ea

Compila un EA MQL5 mediante MetaEditor

list_experts

Lista todos los EA del directorio MQL5/Experts

list_indicators

Lista todos los indicadores del directorio MQL5/Indicators

list_scripts

Lista todos los scripts del directorio MQL5/Scripts

healthcheck

Comprobación rápida del estado del servidor

list_symbols

Lista todos los símbolos disponibles en el terminal MT5

Analíticas granulares (análisis individual)

Herramienta

Descripción

analyze_monthly_pnl

Desglose mensual de P/L solamente

analyze_drawdown_events

Eventos de drawdown y sus causas solamente

analyze_top_losses

Peores operaciones perdedoras solamente

analyze_loss_sequences

Patrones de pérdidas consecutivas solamente

analyze_position_pairs

Tiempo de retención de posiciones y pares de P/L

analyze_direction_bias

Rendimiento de compra vs venta

analyze_streaks

Análisis de rachas ganadoras/perdedoras

analyze_concurrent_peak

Máximo de posiciones simultáneas

Usa estas herramientas para un análisis específico, o analyze_report para ejecutarlas todas a la vez.

Analíticas a nivel de operación (Nuevo)

Herramienta

Descripción

list_deals

Lista operaciones individuales con filtros (tipo, rango de beneficio, volumen, fechas)

search_deals_by_comment

Búsqueda de texto completo en comentarios de operaciones (p. ej., "Layer #3")

search_deals_by_magic

Filtra operaciones por número mágico del EA

analyze_profit_distribution

Histograma de beneficios: ganancias y pérdidas pequeñas/medianas/grandes

analyze_time_performance

Rendimiento por hora del día y día de la semana

analyze_hold_time_distribution

Rangos de tiempo de retención + correlación con el beneficio

analyze_layer_performance

Análisis de capas de grid/martingala a partir de los comentarios

analyze_volume_vs_profit

Correlación de volumen + rendimiento por tamaño de lote

analyze_costs

Impacto de comisiones y swaps en la rentabilidad

analyze_efficiency

Beneficio por hora/día, retorno anualizado, frecuencia de operaciones

Supervisión

Herramienta

Descripción

verify_setup

Comprueba las rutas de Wine/MT5, la versión de Wine y el número de archivos EA/set

get_optimization_status

Comprueba el estado en vivo de un trabajo de optimización en segundo plano

list_jobs

Todos los trabajos de optimización con estado compacto en una sola llamada

Informes y registros

Herramienta

Descripción

list_reports

Tabla compacta de todas las ejecuciones con métricas clave: no se necesita un análisis completo

get_latest_report

Obtén el informe más reciente con gráfico de equity opcional

search_reports

Encuentra informes por EA, símbolo, rango de fechas o criterios de beneficio

get_report_by_id

Obtén un informe específico por ID con gráfico de equity

get_reports_summary

Estadísticas agregadas: recuentos, promedios, tasas de aprobación

get_best_reports

Los N mejores informes ordenados por cualquier métrica (factor de beneficio, drawdown, etc.)

search_reports_by_tags

Encuentra informes por etiquetas

search_reports_by_date_range

Consulta por rango de fechas de backtest

search_reports_by_notes

Búsqueda de texto completo en las notas de los informes

get_reports_by_set_file

Encuentra todos los informes que usan un archivo .set específico

get_comparable_reports

Encuentra informes comparables (mismo EA/símbolo/marco temporal)

tail_log

Lee las últimas N líneas de cualquier registro; filter=errors para ver solo fallos

prune_reports

Elimina directorios de informes antiguos y conserva los últimos N (omite los directorios _opt)

promote_to_baseline

Escribe una entrada de historial o informe en baseline.json para compare_baseline

Historial y línea base

Herramienta

Descripción

archive_report

Convierte un directorio de informe → entrada JSON compacta en backtest_history.json, opcionalmente elimina el origen

archive_all_reports

Archiva en bloque todos los directorios de informes y luego opcionalmente los elimina; conserva los N más recientes a salvo

get_history

Consulta el historial con filtros (EA, símbolo, veredicto, beneficio, DD) y opciones de ordenación

annotate_history

Adjunta veredicto / notas / etiquetas a cualquier entrada del historial

Gestión de caché

Herramienta

Descripción

cache_status

Desglose del tamaño de la caché del tester de MT5 por símbolo: compruébalo antes de limpiar

clean_cache

Elimina archivos de caché del tester; admite por símbolo y dry_run

Verificación previa y validación

Herramienta

Descripción

get_active_account

Obtén la sesión de cuenta MT5 actual (login, servidor, símbolos disponibles)

check_symbol_data_status

Valida que el símbolo tenga suficientes datos históricos para el rango de fechas

check_mt5_status

Comprueba si el terminal MT5 está instalado y listo

validate_ea_syntax

Comprobación de sintaxis previa a la compilación sin ejecutar la compilación completa

Depuración y diagnósticos (Nuevo)

Herramienta

Descripción

diagnose_wine

Comprueba la instalación de Wine, la versión y el estado del prefijo

get_mt5_logs

Obtiene los registros del terminal MT5, del tester o de MetaEditor con filtrado

search_mt5_errors

Busca en los registros patrones de error (bloqueo, excepción, violación de acceso)

check_mt5_process

Comprueba si los procesos de MT5 están en ejecución; obtiene PID, uso de CPU y memoria

kill_mt5_process

Finaliza procesos de MT5 bloqueados (force=true para wineserver)

check_system_resources

Comprueba el espacio en disco, la memoria y la disponibilidad de CPU

validate_mt5_config

Valida terminal.ini y los archivos de configuración del tester

get_wine_prefix_info

Obtiene los detalles del prefijo de Wine: versión de Windows, programas instalados, registro

get_backtest_crash_info

Investiga fallos de backtest: marcadores incompletos, deals.csv ausente, errores

check_update

Comprueba si hay una versión más reciente de MT5-Quant disponible

update

Actualiza MT5-Quant a la última versión

Gestión de proyectos

Herramienta

Descripción

init_project

Crea un nuevo proyecto MQL5 con plantillas (scalper/swing/grid/basic)

create_set_template

Genera un archivo de parámetros .set a partir de las variables de entrada del EA

export_report

Exporta el informe de backtest a CSV, JSON o Markdown

Historial y comparación

Herramienta

Descripción

get_backtest_history

Enumera todos los backtests del EA/símbolo con métricas resumidas

compare_backtests

Compara 2 o más resultados de backtest en paralelo con análisis

Archivo .set — lectura / escritura

Herramienta

Descripción

list_set_files

Todos los archivos .set en el directorio de perfiles del tester con estadísticas de barrido y recuentos de combinaciones

read_set_file

Analiza el archivo .set UTF-16LE → parámetros JSON estructurados

write_set_file

Escribe el diccionario completo de parámetros → .set UTF-16LE con chmod 444

patch_set_file

Actualiza parámetros específicos in situ y devuelve el diff; sustituye a leer→editar→escribir

clone_set_file

Copia .set a una nueva ruta con anulaciones opcionales en una sola llamada

Archivo .set — análisis y generación

Herramienta

Descripción

describe_sweep

Parámetros barridos, recuentos de valores y combinaciones totales de optimización

diff_set_files

Diff en paralelo de dos archivos .set; solo se devuelven los parámetros modificados

set_from_optimization

Genera un .set de backtest limpio a partir de los parámetros de get_optimization_results; opcionalmente, reduce el barrido

Búsqueda y descubrimiento

Herramienta

Descripción

search_experts

Busca EAs por patrón de nombre en todos los directorios

search_indicators

Busca indicadores por patrón de nombre

search_scripts

Busca scripts por patrón de nombre

copy_indicator_to_project

Copia el indicador al directorio del proyecto

copy_script_to_project

Copia el script al directorio del proyecto

Esquema completo: docs/MCP_TOOLS.md

Resolución de problemas

Ejecuta verify_setup desde tu LLM primero — comprueba todas las rutas y devuelve sugerencias prácticas.

Para bloqueos o fallos inexplicables durante backtest/compilación/optimización:

  • diagnose_wine — Comprueba la instalación de Wine y el estado del prefijo

  • search_mt5_errors — Encuentra las causas de los bloqueos en los registros

  • check_mt5_process + kill_mt5_process — Detecta y finaliza procesos bloqueados

  • get_backtest_crash_info — Investiga informes de backtest fallidos

Guía completa de resolución de problemas →

Documentación

Documento

Descripción

QUICKSTART

Instalación, configuración y primer backtest paso a paso

MCP_TOOLS

Esquemas completos de entrada/salida para las 90 herramientas

CONFIG

Referencia de configuración (config/mt5-quant.yaml)

ARCHITECTURE

Principios de diseño y estructura interna de módulos

REMOTE_AGENTS

Distribuye la optimización entre agentes Linux mediante Wine

TROUBLESHOOTING

Soluciones específicas por plataforma para Wine, MT5 y backtests

Índice completo con orden de lectura: docs/INDEX.md

Agradecimientos

MT5-Quant se apoya en hombros de proyectos de código abierto excepcionales:

  • Rust — El lenguaje que hace prácticas las abstracciones de coste cero, la seguridad de memoria y la concurrencia sin miedo

  • Tokio — El runtime asíncrono que impulsa todas las operaciones concurrentes

  • Wine — Hace posible la ejecución de MT5 en macOS y Linux sin licencia de Windows

  • MetaTrader 5 — La plataforma de trading de MetaQuotes (marca comercial de MetaQuotes Software Corp.)

  • rusqlite — Enlaces SQLite ergonómicos para Rust

  • serde — El framework de serialización que hace que la gestión de configuración e informes sea sencilla

  • scraper — Análisis de HTML para la extracción de informes de MT5

  • tempfile — Gestión segura de archivos temporales

Agradecimiento especial al equipo de Model Context Protocol (MCP) de Anthropic por definir el estándar que hace posibles los flujos de trabajo de desarrollo impulsados por IA.

Descargo de responsabilidad

No es asesoramiento financiero. MT5-Quant es una herramienta de desarrollo y análisis para estrategias de trading algorítmico. No proporciona asesoramiento de inversión, recomendaciones de trading ni garantiza rentabilidad. Todos los resultados de backtest son simulaciones históricas y no garantizan resultados futuros.

Úsalo bajo tu propio riesgo. El trading con instrumentos financieros conlleva un riesgo sustancial de pérdida. Los autores y colaboradores de MT5-Quant no aceptan ninguna responsabilidad por:

  • Pérdidas de trading incurridas al usar estrategias desarrolladas o probadas con esta herramienta

  • Pérdida o corrupción de datos por operaciones de backtest

  • Errores, fallos o resultados de análisis incorrectos

  • Bloqueos del sistema, problemas de compatibilidad con Wine o fallos de MT5

Garantía del software. Este software se proporciona «tal cual», sin garantía de ningún tipo, expresa o implícita, incluidas, entre otras, las garantías de comerciabilidad, idoneidad para un fin particular o no infracción. Consulta LICENSE para conocer los términos completos.

Software de terceros. MT5-Quant interactúa con MetaTrader 5, Wine y otro software de terceros. Los usuarios son responsables de cumplir todas las licencias y términos de servicio aplicables de estas dependencias. MetaTrader es una marca comercial de MetaQuotes Software Corp. MT5-Quant no está afiliado a MetaQuotes, ni cuenta con su respaldo o patrocinio.

Cumplimiento normativo. Los usuarios son responsables de garantizar que sus actividades de trading cumplan la normativa financiera aplicable en su jurisdicción. El trading automatizado puede estar restringido o requerir licencia en algunas regiones.

Licencia

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • mcp-metaeditor

    CtpN3m01
    F
    license
    Not graded
    quality
    C
    maintenance
    Connects MCP clients to MetaTrader 5 MetaEditor on Linux via Wine, enabling automated MQL5 development workflows including code editing, compilation of EAs/indicators, and strategy backtesting.
    5
    -

  • mt4ctl

    ak40u
    A
    license
    A
    quality
    C
    maintenance
    An MCP server for operating headless MetaTrader 4 terminals remotely over SSH, enabling status checks, logs, screenshots, systemd control, and automated first-login.
    13
    1
    MIT

  • mt5ctl

    Chust-dev
    A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server for operating headless MetaTrader 5 terminals — over SSH, from your agent.
    MIT

  • mt5-mcp

    alikhande70
    A
    license
    Not graded
    quality
    C
    maintenance
    A local-first MCP server that bridges AI coding agents with MetaTrader 5 for inspection, market data, MQL5 development, compiling, Strategy Tester review, workspace sync, logs, audit trails, demo trading, and carefully gated live trading.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/masdevid/mt5-quant'

If you have feedback or need assistance with the MCP directory API, please join our Discord server