metatrader5-mcp

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/)

A Model Context Protocol (MCP) server that provides comprehensive access to MetaTrader 5 trading platform functionality through Python.

> 📖 New to this project? Check out the Quick Start Guide for a condensed reference!

• MetaTrader 5 terminal installed and running on Windows
• Python 3.10+

Windows:

# Clone the repository
git clone https://github.com/amirkhonov/metatrader5-mcp.git
cd metatrader5-mcp

# Run installation script
install.bat

Linux/Mac:

# Clone the repository
git clone https://github.com/amirkhonov/metatrader5-mcp.git
cd metatrader5-mcp

# Run installation script
chmod +x install.sh
./install.sh

# Install from source
git clone https://github.com/amirkhonov/metatrader5-mcp.git
cd metatrader5-mcp
pip install -r requirements.txt
pip install -e .

git clone https://github.com/amirkhonov/metatrader5-mcp.git
cd metatrader5-mcp
poetry install

1. Copy the environment template:

   cp .env.example .env

1. Edit `.env` with your MT5 credentials:

   MT5_LOGIN=12345678
   MT5_PASSWORD=your_password
   MT5_SERVER=MetaQuotes-Demo
   MT5_PATH=C:\Program Files\MetaTrader 5\terminal64.exe

1. Run the server:

   # Using environment variables from .env
   metatrader5-mcp

   # Or with command line arguments
   metatrader5-mcp --login 12345 --password secret --server MetaQuotes-Demo

# Check if the server starts correctly
metatrader5-mcp --help