# MetaTrader 5 MCP Bridge

Даёт агенту доступ к счёту MetaTrader 5: котировки, позиции, история и сделки. Каждая заявка проходит через подтверждение человеком.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: vincentwongso
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/vincentwongso/mt5-trading-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/metatrader-5-mcp-bridge

## Что делает

Сервер поднимается локально, в том же процессе, что и агент: ни облака, ни телеметрии. Читающих инструментов двенадцать — счёт, котировки, позиции, ордера, история, бары OHLC, оценка маржи от брокера и снимки графиков. Согласие на них не спрашивают.

Мутирующих инструментов четыре: `place_order`, `modify_order`, `cancel_order`, `close_position`. Перед каждой заявкой идёт предполётная проверка, затем шлюз подтверждения, который включается по желанию, потом защита от повторов и журнал аудита только на дозапись. Так у вас остаётся воспроизводимая запись того, что делал агент. Ещё есть три ресурса с подпиской — `account://`, `positions://` и `quotes://{symbol}` — они шлют уведомления об изменениях.

Это софт, который выставляет настоящие ордера с необратимым исполнением. Сначала прогоняйте всё на демо-счёте. На Windows нужен Python 3.10+ и включённый AlgoTrading в терминале; на Linux всё идёт через Docker, а снимки графиков там недоступны — для них нужен MQL5-советник `AgentScreenshot` в GUI-терминале. В комплекте два готовых скилла Claude: `mt5-market-data` и `mt5-trading`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `MT5_LOGIN`, `MT5_PASSWORD`, `MT5_SERVER` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env MT5_LOGIN=<MT5_LOGIN> --env MT5_PASSWORD=<MT5_PASSWORD> --env MT5_SERVER=<MT5_SERVER> --transport stdio metatrader-5-mcp-bridge -- uvx mt5-trading-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mt5-trading-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add metatrader-5-mcp-bridge --env MT5_LOGIN=<MT5_LOGIN> --env MT5_PASSWORD=<MT5_PASSWORD> --env MT5_SERVER=<MT5_SERVER> -- uvx mt5-trading-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mt5-trading-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "metatrader-5-mcp-bridge": {
            "command": "uvx",
            "args": [
                "mt5-trading-mcp"
            ],
            "env": {
                "MT5_LOGIN": "<MT5_LOGIN>",
                "MT5_PASSWORD": "<MT5_PASSWORD>",
                "MT5_SERVER": "<MT5_SERVER>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mt5-trading-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "metatrader-5-mcp-bridge": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mt5-trading-mcp"
            ],
            "env": {
                "MT5_LOGIN": "<MT5_LOGIN>",
                "MT5_PASSWORD": "<MT5_PASSWORD>",
                "MT5_SERVER": "<MT5_SERVER>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mt5-trading-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MT5_LOGIN=<MT5_LOGIN> -e MT5_PASSWORD=<MT5_PASSWORD> -e MT5_SERVER=<MT5_SERVER> metatrader-5-mcp-bridge uvx mt5-trading-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mt5-trading-mcp <команда>

## Когда брать
- посмотреть баланс и открытые позиции, не открывая терминал
- выставить ордер по описанию на словах и подтвердить его вручную
- снять снимок графика с разметкой уровней для разбора агентом
- получить оценку маржи от брокера перед входом в сделку
- восстановить по журналу, что именно делал агент со счётом

## Примеры запросов агенту
- Покажи открытые позиции и баланс счёта.
- Поставь лимитный ордер на 0.01 лота по EURUSD, покажи параметры до подтверждения.
- Сделай снимок графика EURUSD на H1 и отметь уровень поддержки.

## Похожие
- [mql5-indicator-patterns](https://affpapa.org/nevibecode/skills/mql5-indicator-patterns.md) — скилл · 497 установок
- [memory-bridge](https://affpapa.org/nevibecode/skills/memory-bridge.md) — скилл · 2400 установок
- [okx-cex-trade](https://affpapa.org/nevibecode/skills/okx-cex-trade.md) — скилл · 10300 установок
- [okx-cex-portfolio](https://affpapa.org/nevibecode/skills/okx-cex-portfolio.md) — скилл · 10100 установок
- [hyperliquid](https://affpapa.org/nevibecode/skills/hyperliquid.md) — скилл · 8700 установок
- [cc-connect-ai-bridge](https://affpapa.org/nevibecode/skills/cc-connect-ai-bridge.md) — скилл · 935 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
