Universal MCP Server for MetaTrader 5 Trading & Data Operations

--- ## Overview FullMt5McpByLeo is a complete, production-ready MCP server that enables Claude and other AI assistants to control MetaTrader 5 directly. Execute trades, retrieve market data, manage charts, analyze trading history, and automate MT5 operations through natural language. --- ## Main Features ### Trade Operations Execute and manage trading positions and orders: - **Open Positions:** Execute market trades (buy/sell) with immediate or pending orders - **Position Management:** Modify stops/profits, close positions (full or partial) - **Order Management:** Create, modify, and cancel pending limit/stop orders - **Trading History:** Query completed deals with profit/loss analysis ### Market Data & Symbols Access real-time and historical data: - **OHLC Data:** Retrieve candlestick data (open, high, low, close, volume) - **Symbol Information:** Get symbol properties (digits, spreads, swaps, volumes) - **Market Watch:** Manage symbol selection and availability ### Graphic Objects Create and modify chart visualizations: - **Draw Objects:** Create trend lines, rectangles, text labels, arrows - **Object Properties:** Modify colors, styles, prices, text - **Chart Annotations:** Add visual markers and indicators to charts ### Chart Management Control chart windows and redraw operations: - **Chart Operations:** Open, close, list active charts - **Chart Properties:** Read chart dimensions, colors, price ranges - **Visual Updates:** Force chart redraw for real-time updates ### Code & Terminal Compile and execute Expert Advisors: - **Compilation:** Compile MQL5 source to EX5 bytecode - **Backtesting:** Run historical tests with multiple tick modeling - **EA Execution:** Run Expert Advisors in real-time - **Logging:** Retrieve EA logs for debugging and monitoring --- ## Quick Start ### 1. Install Pacakage ```bash pip install mt5-mcp-by-leo ``` ### 2. Configure Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "mt5_mcp_by_leo": { "command": "python", "args": ["-m", "mt5_mcp_by_leo", "--host", "127.0.0.1", "--port", "9999"] } } } ``` ### 3. Configure MetaTrader 5 In MT5: **Tools** → **Options** → **Allowed URLs for WebRequest** - Add `127.0.0.1` or host you configured. - Click **Accept** - Enable AutoTrading and DLL imports ### 4. Compile & Attach EA ``` MetaEditor: Open Src/Mt5Mcp.mq5 → Compile (F5) MT5: Drag Mt5Mcp.ex5 onto your chart and cofigure it, The parameters of the EA, such as port/host, must match the JSON of Claude Desktop ``` Notes: - To run backtests, you need to add the ea Runner.ex5 (from releases) to any chart. ### 5. Use in Claude ``` Open a 0.01 lot BUY on EURUSD with SL at 1.0800 and TP at 1.0900 ``` --- ## Repository Structure ``` FullMt5McpByLeo/ ├── Src/ # MQL5 Backend Functions │ .... ├── mt5_mcp_by_leo/ # Python MCP Server │ .... ``` --- ## Requirements - Python >= 3.10 - Dependencies listed in dependencies.json (or sub-dependencies of this repo) --- ## Installation ```bash cd "C:\Users\YOUR USER\AppData\Roaming\MetaQuotes\Terminal\YOUR ID\MQL5\Shared Projects" tsndep install "https://forge.mql5.io/nique_372/FullMt5McpByLeo.git" ``` - For use tsndep command requerid tsndep pacakage (avaible in [pypi](https://pypi.org/project/tsndep)).. This command automatically downloads all dependencies and installs all requirements from the repositories. - If any part of the system is private, then it will fail... contact me so I can give you access (if it's a product, you can buy it; if you have any questions, don't hesitate to contact me). --- ## Available Tools ### Trade Operations (19 Functions) - **Opening:** `open_trade`, `open_limit`, `open_stop` - **Management:** `position_list`, `position_get_*` (double/integer/string), `position_close`, `position_modify` - **Orders:** `order_list`, `order_close`, `order_modify`, `order_get_*` (double/integer/string) - **History:** `history_deal_list`, `history_deal_get_*` (double/integer/string) ### Market Data & Symbols (10 Functions) - **OHLC:** `copy_open`, `copy_high`, `copy_low`, `copy_close`, `copy_tick_volume` - **Symbols:** `symbol_info_*` (double/integer/string), `symbol_select`, `symbols_total` ### Graphic Objects (5 Functions) - `object_create`, `object_delete`, `object_integer`, `object_double`, `object_string` ### Chart Management (6 Functions) - `chart_list`, `chart_open`, `chart_close`, `chart_get_integer`, `chart_get_double`, `chart_redraw` ### Code & Terminal (4 Functions) - `compile_mql5`, `execute_backtest`, `run_ea`, `get_expert_logs` --- ## License **[Read Full License](./LICENSE)** By downloading or using this repository, you accept the license terms. --- ## Documentation - Wiki: [https://forge.mql5.io/nique_372/FullMt5McpByLeo/wiki](https://forge.mql5.io/nique_372/FullMt5McpByLeo/wiki) --- ## Contact - **Platform:** [MQL5 Community](https://www.mql5.com/es/users/nique_372) - **Profile:** https://www.mql5.com/es/users/nique_372/news ---