MetaTrader 5 MCP Server & Distrobox Automation

Name: MetaTrader 5 MCP Server & Distrobox Automation
Author: chymian

@chymian

Repository

About MetaTrader 5 MCP Server & Distrobox Automation

A MCP-Server to control Metatrader5 for EA optimization

Basic information

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MetaTrader 5 MCP Server & Distrobox Automation?

An automated workflow for running, optimizing, and documenting MetaTrader 5 Expert Advisors (EAs) using a Distrobox container, a Flask REST API, and an MCP server. It integrates MetaTrader 5 (via Wine/Distrobox) with programmatic EA optimization and a unified MCP interface for trading, optimization, and result retrieval.

How to use MetaTrader 5 MCP Server & Distrobox Automation?

Create the Distrobox container with distrobox-assemble create --file src/mt5.ini -R and enter it with distrobox-enter mt5. The Flask API starts automatically and is accessible at http://localhost:5000. Use the MCP server (src/mt5-server.ts) to trigger optimizations and generate reports. Results are saved to ~/mt5-dev/result/manual/tuning/.

Key features of MetaTrader 5 MCP Server & Distrobox Automation

MetaTrader 5 setup and launch via Wine in Distrobox.
Flask REST API for programmatic EA optimization.
MCP server for unified trading and optimization interface.
Automated HTML and Markdown optimization reports.
Git version control for all code and configuration.

Use cases of MetaTrader 5 MCP Server & Distrobox Automation

Run and optimize MT5 Expert Advisors in a containerized environment.
Automate EA tuning and generate human‑readable documentation.
Integrate MT5 operations into MCP‑compatible AI workflows.

FAQ from MetaTrader 5 MCP Server & Distrobox Automation

What does the MCP server provide?

It provides tools for trading operations (get_account_info, create_order) and optimization operations (run_optimization, get_optimization_status, get_optimization_results, save_optimization_results).

What are the runtime requirements?

A Linux host with Distrobox, Wine, Python3, pip, Flask, MetaTrader5, pandas, jinja2, git, and Node.js/TypeScript for the MCP server. The Distrobox container handles most dependencies automatically.

Where are optimization results stored?

By default, all logs, data, and results are stored in ~/mt5-dev. HTML and Markdown reports are saved to ~/mt5-dev/result/manual/tuning/<EA_NAME>_tuning.html and .md.

Can I customize configuration?

Copy src/mt5.ini to src/mt5-dev.ini and edit as needed. The mt5-dev.ini file is ignored by git and not tracked.

How does the Flask API work?

It runs inside the Distrobox container on port 5000. Endpoints include POST /optimize, GET /optimization_status/<id>, GET /optimization_results/<id>, and POST /save_results.