Skip to main content
Glama
deenesjakoruzh
tradingmavenfx-cmd

MT5 MCP Server

by tradingmavenfx-cmd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

MT5 MCP Server

Un servidor MCP local que conecta un terminal de MetaTrader 5 con Claude. Lee datos de mercado, estado e historial de la cuenta, toma capturas de pantalla de gráficos y puede enviar órdenes en vivo.

Requisitos

  1. El terminal de MetaTrader 5 debe estar en ejecución

  2. Herramientas → Opciones → Asesores expertos → "Permitir el trading algorítmico" debe estar habilitado

  3. Debe haber una cuenta con sesión iniciada

Si el terminal está cerrado, todas las herramientas devuelven MT5 initialize failed — ábrelo e inténtalo de nuevo.

Related MCP server: metatrader-mcp

Instalación

uv venv --python 3.12 .venv
uv pip install --python .venv/Scripts/python.exe -r requirements.txt

Luego ajusta las rutas en .mcp.json y reinicia Claude Code.

Herramientas (20)

Datos de mercado

Herramienta

Qué hace

mt5_status

Compilación del terminal, conexión, cuenta, saldo, equity, margen, DEMO/REAL

list_symbols

Buscar símbolos — se admiten comodines (EUR*, *USD*)

symbol_info

Dígitos, punto, spread, tamaño del contrato, límites de lote, margen y tasas de swap

get_ticks

Bid/ask en vivo y spread para uno o más símbolos

get_candles

OHLCV de M1 a MN1, por número o por rango de fechas

get_tick_history

Flujo de ticks bid/ask sin procesar, útil para backtesting

Cuenta

Herramienta

Qué hace

get_positions

Posiciones abiertas y P/L flotante total

get_pending_orders

Órdenes limit y stop activas

get_history_deals

Operaciones cerradas con totales de beneficio, comisión y swap

get_history_orders

Órdenes que se colocaron, cancelaron o rechazaron

calc_trade

Margen y beneficio esperado antes de enviar nada (no se coloca ninguna orden)

Captura de pantalla

Herramienta

Qué hace

list_charts

Gráficos abiertos con símbolo, marco temporal y tamaño

screenshot

PNG de la ventana del terminal o de un solo gráfico

screenshot no proviene de la API de Python de MetaTrader5 — esa API no tiene ninguna función de captura de pantalla. Está construido sobre la llamada PrintWindow de Windows (mt5_capture.py). Funciona en una ventana en segundo plano, pero no en una minimizada.

Pasa target='window' para todo el terminal, o target='XAUUSD,M30' para un solo gráfico. Si pasas solo 'XAUUSD', se selecciona el gráfico más grande para ese símbolo.

Trading — en vivo

Herramienta

Qué hace

open_position

Compra/venta a mercado, SL/TP como precio absoluto o en puntos

place_pending_order

Límite o stop de compra/venta, con vencimiento opcional

modify_position

Cambiar SL/TP en una posición abierta

modify_pending_order

Cambiar precio, SL o TP en una orden pendiente

close_position

Cierre total o parcial

cancel_pending_order

Eliminar una orden pendiente

close_all_positions

Cerrar todo, o solo un símbolo

⚠️ No hay protección demo/real en las herramientas de trading. Las órdenes van a la cuenta en la que el terminal haya iniciado sesión. El modo de llenado del bróker se detecta automáticamente y el símbolo se añade a Market Watch cuando sea necesario.

CLI (trade.py)

Las mismas herramientas sin Claude, directamente desde la línea de comandos:

.venv/Scripts/python.exe trade.py buy XAUUSD 0.01 --sl-points 500 --tp-points 1000
.venv/Scripts/python.exe trade.py modify 10090941191 --sl 4345.56 --tp 4360.56
.venv/Scripts/python.exe trade.py close 10090941191
.venv/Scripts/python.exe trade.py close-all --symbol XAUUSD
.venv/Scripts/python.exe trade.py positions
.venv/Scripts/python.exe trade.py calc buy XAUUSD 0.01 --close-price 4360

Ejecuta trade.py --help para cada subcomando.

Formato de hora

Todas las entradas de hora están en UTC: YYYY-MM-DD, YYYY-MM-DD HH:MM o YYYY-MM-DD HH:MM:SS. Las marcas de tiempo de salida también están en UTC.

Configuración

Estas variables de entorno son opcionales en .mcp.json:

Variable

Propósito

MT5_PATH

Ruta a terminal64.exe, utilizada para lanzar el terminal si está cerrado

MT5_LOGIN / MT5_PASSWORD / MT5_SERVER

Iniciar sesión en una cuenta diferente (por defecto: la que ya use el terminal)

Prueba de humo

.venv/Scripts/python.exe -c "import mt5_mcp_server as s; print(s.mt5_status()['account'])"

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MetaTrader 5 MCP Server

    amirkhonov
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables comprehensive access to the MetaTrader 5 trading platform for retrieving market data, managing accounts, and executing trading operations. It provides 32 specialized tools for interacting with MT5 functionalities, including historical OHLCV data access, real-time position monitoring, and automated order management.
    1
    MIT

  • metatrader-mcp

    ali-rajabpour
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to capture real MetaTrader 5 chart snapshots with custom indicators and fetch market data through natural language in Claude Desktop.
    3
    MIT

  • MT5 MCP Server

    junmt
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with MetaTrader 5 for market data, technical analysis, Fibonacci calculations, and trading via MCP clients such as Claude.
    MIT

  • HTS MetaTrader5 Trading MCP

    Yumin-Kim
    F
    license
    A
    quality
    D
    maintenance
    Enables Claude AI to perform forex trading operations and market data analysis through MetaTrader 5, including order placement, position management, and multi-timeframe candle data retrieval.
    16
    -