Metatrader MCP

Automated MetaTrader 5 trading strategy optimization and documentation generation system

Finance Developer tools #Trading Optimization #Automation #Containerization #API Service Remote .TypeScript

rating : 2.5 points

downloads : 19

update time : 2025-04-28

What is MetaTrader 5 MCP Server?

This is a complete solution that integrates the MetaTrader 5 trading platform, automated optimization tools, and a result reporting system. Through containerization technology (Wine/Distrobox) and REST API, users can easily run and optimize trading strategies and automatically generate detailed optimization reports.

How to use MetaTrader 5 MCP Server?

The system can be started through simple command-line or API calls. Users can submit optimization tasks, monitor progress, and obtain results through the REST API or the MCP server interface. All operations have clear documentation and examples.

Use Cases

Suitable for quantitative trading developers, individual traders, and fintech researchers for strategy development, parameter optimization, and performance testing. Particularly suitable for scenarios where MT5 needs to be run in an isolated environment.

Main Features

Containerized MT5 EnvironmentProvides a fully isolated MT5 operating environment through Distrobox and Wine, avoiding conflicts with the host system.

REST API InterfaceProvides a standardized HTTP interface for easy integration with other systems and automated operations.

Automated Documentation GenerationAutomatically generates detailed reports in HTML and Markdown formats after each optimization, including all key indicators and parameters.

MCP ServerA unified management interface that provides trading operations, optimization control, and result retrieval functions.

Version Control IntegrationAutomatically initializes a Git repository to ensure that all changes and optimization results have a complete historical record.

Advantages and Limitations

Advantages

A ready-to-use complete solution that reduces environment configuration time

An isolated operating environment avoids system pollution and conflicts

Automated report generation saves a lot of manual sorting time

A standard API interface facilitates integration with other systems

Version control ensures that all changes are traceable

Limitations

Requires some knowledge of Linux command lines

Some MT5 functions may be limited in the Wine environment

Optimizing a large number of parameters may require more computing resources

Downloading large files is required for the initial setup of the container environment

How to Use

Set Up the Distrobox Container

Create and enter the container environment using the provided configuration file.

Start the Flask API Service

The API service will start automatically after entering the container. It can also be started manually through commands.

Use the API or MCP Server

Submit optimization tasks and obtain results through HTTP requests or the MCP server interface.

View Optimization Results

The results will be automatically saved to the specified directory, including reports in HTML and Markdown formats.

Usage Examples

Optimize the Moving Average StrategyOptimize the parameters of a trading strategy based on moving averages and test the performance of different period combinations.

Multi-Symbol Batch TestingRun the same strategy on multiple trading symbols simultaneously to compare performance in different markets.

Frequently Asked Questions

How to access the generated reports?

Can an optimization task be interrupted?

Is customizing report templates supported?

How to add a new EA for optimization?

How much system resources does it consume?

Related Resources

MetaTrader 5 Documentation

Official documentation for using the MT5 platform

Distrobox Project

Official repository of the containerization tool

Flask REST API Tutorial

Official tutorial for the Flask framework

Sample EA Code Repository

Examples of common trading strategies

🚀 MetaTrader 5 MCP Server and Distrobox Automation

This project offers a fully automated process for running, optimizing, and documenting MetaTrader 5 (MT5) Expert Advisors (EAs) using a Distrobox container, a Flask REST API, and an MCP server.

🚀 Quick Start

1. Distrobox Container Setup

To assemble and enter the Distrobox container, run the following commands from the project root directory:

distrobox-assemble create --file src/mt5.ini -R
distrobox-enter mt5

Check src/mt5.ini for the full automated Distrobox configuration.
During container creation, the following will be automatically installed and configured:
- Wine, MT5, Python3, pip, Flask, MetaTrader5, pandas, jinja2, git, and all necessary tools.
- The Flask API will start automatically.
- A git repository will be initialized, and all files will be committed.

2. Flask REST API

Located at src/mt5_flask_api.py.
The API is accessible on the host at http://localhost:5000 (default port 5000 is published; see src/mt5.ini).
Example: Test the API from the host system:

curl http://localhost:5000/optimization_status/some-id

Endpoints:
- POST /optimize: Start an optimization run.
- GET /optimization_status/<id>: Check the optimization status.
- GET /optimization_results/<id>: Retrieve the results.
- POST /save_results: Save the results as HTML/Markdown/CSV/JSON.
Results are saved to ~/mt5-dev/result/manual/tuning/<EA_NAME>_tuning.html and .md.

3. MCP Server

Check src/mt5-server.ts for the MCP server implementation.
Tools include:
- Trading operations (get_account_info, create_order, etc.)
- Optimization operations (run_optimization, get_optimization_status, get_optimization_results, save_optimization_results)

4. Usage Examples

Start the container (Distrobox will perform all setup and start the Flask API).
Use the MCP server to trigger optimizations and generate reports.
Open the HTML/Markdown reports in ~/mt5-dev/result/manual/tuning/ for a clear overview.

✨ Features

MetaTrader 5 in Wine/Distrobox: Automated setup and startup.
Flask REST API: Programmatically optimize EAs, providing endpoints for running, monitoring, and saving results.
MCP Server: A unified interface for trading, optimization, and result retrieval.
Automated Documentation Generation: Optimization results are saved as HTML and Markdown reports, with individual records for each EA.
Git Version Control: Version all code and configurations from the start.

📚 Working Directory and Configuration

By default, all logs, data, results, and outputs are stored in ~/mt5-dev to ensure portability and consistency. To override any configuration values for local development, copy src/mt5.ini to src/mt5-dev.ini and customize as needed. The src/mt5-dev.ini file is not tracked or pushed by Git.