mcp-metaeditor

MCP server that connects Claude Code (or any MCP client) to the MetaTrader 5 MetaEditor toolchain on Linux via Wine.

It lets you automate a full MQL5 workflow:

• browse MQL5 files,
• read/write code,
• compile EAs/indicators/scripts,
• run backtests and inspect results.

Quick install (Claude Code)

1. Install dependencies:

npm install

2. Build the server:

npm run build

3. Register this MCP in Claude Code:

claude mcp add mcp-metaeditor node "$PWD/dist/index.js"

Run this command from the project root directory.

4. Verify it is registered:

claude mcp list

5. Start a new Claude Code session and use tools like list_mql5_files.

Requirements

• Linux
• Wine installed and working
• MetaTrader 5 installed inside your Wine prefix
• Node.js 20+
• npm

Configuration

Supported environment variables:

• MT5_WINEPREFIX (default: ~/.mt5)
• MT5_PATH (default: ~/.mt5/drive_c/Program Files/MetaTrader 5)

Example:

export MT5_WINEPREFIX="$HOME/.mt5"
export MT5_PATH="$HOME/.mt5/drive_c/Program Files/MetaTrader 5"

The server validates on startup that MT5_PATH, MetaEditor64.exe, and MQL5 exist.

Available MCP tools

Files

• list_mql5_files(type, pattern?)
• read_mql5_file(path)
• write_mql5_file(path, content)

Compile

• compile_mql5(path)
• get_compile_errors(path)

Backtest

• run_backtest(expert, symbol, period, date_from, date_to, deposit?, leverage?)
• get_backtest_results(expert?)

Recommended workflow

1. write_mql5_file to create/update your EA.
2. compile_mql5 to compile.
3. get_compile_errors to inspect errors/warnings.
4. run_backtest to launch a test.
5. get_backtest_results to inspect output.

npm scripts

• npm run build — compile TypeScript into dist/
• npm start — run dist/index.js
• npm run dev — watch mode TypeScript compilation

License

MIT