MetaTrader 5 (MT5) MCP Server & Web GUI Workstation

Высокопроизводительный Model Context Protocol (MCP) сервер и интерактивная Web GUI Workstation для MetaTrader 5 на Windows. Этот проект подключает AI-ассистентов (Antigravity, Claude Desktop, Cursor и др.) и количественных трейдеров напрямую к их локальной установке MT5 для:

1. Получения исторических рыночных данных (бары OHLCV на таймфреймах M1–MN1 и потоки тиков с точностью до миллисекунды) с быстрым экспортом в Parquet и CSV.

2. Запуска бэктестов стратегий с помощью встроенных количественных движков на Python и автоматизации нативного тестера стратегий MT5 (terminal64.exe /config:tester.ini).

3. Просмотра статуса демо-счета, кривых капитала, активных символов, котировок в окне рынка и открытых позиций.

4. Интерактивный финансовый веб-интерфейс: создан с использованием TradingView Lightweight Charts, телеметрии в реальном времени, Strategy Studio с визуализатором кривой капитала и менеджером входа в аккаунт.

5. Строгая защита торговли: гарантирует, что демо- и реальные ордера могут исполняться только при явном подтверждении.

Обзор архитектуры

 ┌────────────────────────────────────────────────────────┐
 │                      AI Client                         │
 │        (Antigravity / Claude Desktop / Cursor)         │
 └───────────────────────────┬────────────────────────────┘
                             │ MCP Protocol (stdio)
 ┌───────────────────────────▼────────────────────────────┐
 │                  MT5 MCP Server (Python)               │
 │   - FastMCP Server (`src/mt5_mcp/server.py`)           │
 │   - Data Caching & Parquet/CSV Export Engine           │
 │   - Quantitative Strategy Backtesting Engine           │
 └─────────────┬────────────────────────────┬─────────────┘
               │                            │
 ┌─────────────▼──────────────┐  ┌──────────▼─────────────┐
 │    MetaTrader5 Python API  │  │ MT5 Native Tester Auto │
 │  - copy_rates_range()      │  │  - tester.ini builder  │
 │  - copy_ticks_range()      │  │  - terminal64.exe CLI  │
 │  - account_info() / login()│  │  - Report XML/HTML     │
 └─────────────┬──────────────┘  └──────────┬─────────────┘
               │                            │
 ┌─────────────▼────────────────────────────▼─────────────┐
 │               MetaTrader 5 Windows Terminal            │
 │               (Demo Account Connected)                 │
 └────────────────────────────────────────────────────────┘

Related MCP server: Meta-Trader-MCP

Установка и предварительные требования

1. Требования

• Windows 10 / 11 (64-bit)

• установленный настольный терминал MetaTrader 5

• Python 3.10, 3.11 или 3.12 (64-bit)

• uv (рекомендуется) или стандартный pip

2. Включение алгоритмической торговли в MT5

В вашем терминале MetaTrader 5:

• Перейдите в Сервис -> Параметры -> Советники.

• Установите флажок Разрешить алгоритмическую торговлю.

• Установите флажок Разрешить импорт DLL (если требуется пользовательскими индикаторами).

3. Настройка виртуальной среды

# Clone the repository
git clone https://github.com/remomein05/mt5-mcp.git
cd mt5-mcp

# Create virtual environment and install dependencies
uv venv --python 3.12 .venv
.venv\Scripts\activate
uv pip install -e ".[dev]"

Web GUI Workstation (Интерактивный дашборд)

Репозиторий включает специализированную финансовую Web GUI Dashboard с графиками TradingView, просмотром рынка в реальном времени, студией бэктеста стратегий и управлением аккаунтом:

# Launch via console script
mt5-mcp-gui

# Or launch via Python module
.venv\Scripts\python -m mt5_mcp.gui --port 8000

Затем откройте http://127.0.0.1:8000 в вашем браузере.

Возможности GUI:

• 📊 TradingView Lightweight Charts: Плавные графики свечей и объемов с интерактивным выбором таймфрейма (M1, M5, M15, M30, H1, H4, D1).

• 📈 Strategy Backtest Studio: Настройка параметров стратегий (SMA Crossover, RSI Reversal, Bollinger Bands), запуск симуляций и просмотр кривых роста капитала, KPI (коэффициент Шарпа, максимальная просадка %, процент выигрышных сделок) и журналов закрытых сделок.

• 📦 Historical Data Exporter: Мгновенное извлечение данных свечей в файлы Parquet и CSV в один клик.

• 🔍 Market Watch: Исследование символов в реальном времени с поиском по шаблону (например, *USD*, Crypto*) и индикаторами плавающего спреда.

• ⚙️ MT5 Connect & Account Login Modal: Бесшовное подключение к активному терминалу MT5 или переключение/вход в любой демо-счет с указанием логина, пароля, брокера/сервера и необязательного пути к исполняемому файлу (отправка по Enter, закрытие по Esc).

• 📋 Open Positions & Native MT5 Tester Panel: Просмотр открытых сделок и автоматизация нативных MQL5-советников в фоновом режиме с помощью пакетных .ini конфигураций.

Конфигурация MCP-клиента

Claude Desktop / Antigravity / Cursor (mcp_config.json)

Добавьте MCP-сервер MT5 в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "mt5": {
      "command": "C:\\Users\\<USER>\\source\\repos\\mt5_mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "mt5_mcp.server"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

Доступные MCP-инструменты

1. Подключение и управление счетом

2. Исследование рынка и исторические данные

3. Тестирование стратегий и симуляция

4. Позиции и торговля (с защитой)

Запуск тестов

Запустите комплексный набор pytest, проверяющий подключение, извлечение исторических данных, количественные бэктесты и REST API графического интерфейса:

.venv\Scripts\pytest -v

Лицензия

Лицензия MIT.