Skip to main content
Glama
deenesjakoruzh
tradingmavenfx-cmd

MT5 MCP Server

by tradingmavenfx-cmd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

MT5 MCP Server

Локальный MCP-сервер, который подключает терминал MetaTrader 5 к Claude. Он читает рыночные данные, состояние счёта и историю, делает скриншоты графиков и может отправлять живые ордера.

Требования

  1. Терминал MetaTrader 5 должен быть запущен

  2. В Сервис → Настройки → Советники должна быть включена опция «Разрешить алгоритмическую торговлю»

  3. Должен быть выполнен вход в аккаунт

Если терминал закрыт, каждый инструмент возвращает MT5 initialize failed — откройте его и повторите попытку.

Related MCP server: metatrader-mcp

Установка

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

Затем настройте пути в .mcp.json и перезапустите Claude Code.

Инструменты (20)

Рыночные данные

Инструмент

Что делает

mt5_status

Сборка терминала, соединение, счёт, баланс, средства, маржа, DEMO/REAL

list_symbols

Поиск символов — поддерживаются подстановочные знаки (EUR*, *USD*)

symbol_info

Цифры, пункт, спред, размер контракта, лимиты лота, маржа и ставки свопа

get_ticks

Живые bid/ask и спред для одного или нескольких символов

get_candles

OHLCV от M1 до MN1, по количеству или по диапазону дат

get_tick_history

Сырой поток тиков bid/ask, полезен для бэктестинга

Счёт

Инструмент

Что делает

get_positions

Открытые позиции и общая плавающая прибыль/убыток

get_pending_orders

Активные лимитные и стоп-ордера

get_history_deals

Закрытые сделки с итогами по прибыли, комиссии и свопу

get_history_orders

Ордера, которые были размещены, отменены или отклонены

calc_trade

Маржа и ожидаемая прибыль до отправки чего-либо (ордер не размещается)

Захват экрана

Инструмент

Что делает

list_charts

Открытые графики с символом, таймфреймом и размером

screenshot

PNG окна терминала или отдельного графика

screenshot не берётся из Python API MetaTrader5 — в этом API вообще нет функции скриншотов. Он построен на вызове Windows PrintWindow (mt5_capture.py). Он работает с фоновым окном, но не со свёрнутым.

Передайте target='window' для всего терминала или target='XAUUSD,M30' для одного графика. Если передать просто 'XAUUSD', будет выбран самый большой график для этого символа.

Торговля — вживую

Инструмент

Что делает

open_position

Рыночная покупка/продажа, SL/TP как абсолютная цена или в пунктах

place_pending_order

Лимитный или стоп-ордер на покупку/продажу, с опциональным сроком

modify_position

Изменение SL/TP на открытой позиции

modify_pending_order

Изменение цены, SL или TP на отложенном ордере

close_position

Полное или частичное закрытие

cancel_pending_order

Удаление отложенного ордера

close_all_positions

Закрыть всё или только один символ

⚠️ Нет защиты demo/real для торговых инструментов. Ордера уходят на тот счёт, в который выполнен вход в терминале. Режим исполнения брокера определяется автоматически, и символ добавляется в Market Watch по мере необходимости.

CLI (trade.py)

Те же инструменты без Claude, прямо из командной строки:

.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

Запустите trade.py --help для каждой подкоманды.

Формат времени

Все входные данные времени в UTC: YYYY-MM-DD, YYYY-MM-DD HH:MM или YYYY-MM-DD HH:MM:SS. Выходные метки времени также в UTC.

Конфигурация

Эти переменные окружения необязательны в .mcp.json:

Переменная

Назначение

MT5_PATH

Путь к terminal64.exe, используется для запуска терминала, если он закрыт

MT5_LOGIN / MT5_PASSWORD / MT5_SERVER

Вход в другой аккаунт (по умолчанию: тот, который уже использует терминал)

Дымовой тест

.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
    -