MCP Metatrader5 Server

🚀 MetaTrader 5 MCP Server

A Model Context Protocol (MCP) server for the MetaTrader 5 platform, enabling AI assistants to interact with MetaTrader 5 for trading and market data analysis.

🚀 Quick Start

The MetaTrader 5 MCP Server allows seamless interaction between AI assistants and the MetaTrader 5 platform. It provides a range of features for trading and market data analysis.

✨ Features

• Connect to the MetaTrader 5 terminal.
• Access market data (symbols, exchange rates, tick data).
• Place and manage trades.
• Analyze trading history.
• Guide AI assistants to interact with users.

📦 Installation

Method 1: Install from PyPI

pip install mcp-metatrader5-server

Method 2: Install from source code

1. Clone the repository:

git clone https://github.com/yourusername/mcp-metatrader5-server.git
cd mcp-metatrader5-server

2. Install dependencies and build the package:

pip install -r requirements.txt
python -m build

💻 Usage Examples

Start the server

• Start in developer mode:

python -m mcp_metatrader5_server.server --mode dev

• Run in production mode:

python -m mcp_metatrader5_server.server --mode prod

Basic Usage

Connect to MetaTrader 5 and get market data

from mcp_metatrader5_server import MarketData

md = MarketData()
symbol = "EUR_USD"
timeframe = "M15"

data = md.get_data(symbol, timeframe)
print(data)

Place and manage trades

from mcp_metatrader5_server import Trading

trading = Trading(account_number="YOUR_ACCOUNT_NUMBER", password="YOUR_PASSWORD")

order_result = trading.open_order(symbol="EUR_USD", order_type="BUY", volume=0.1)
print(order_result)

positions = trading.get_positions()
print(positions)

📚 Documentation

Resources

• MetaTrader 5 API Documentation
• MCP Protocol Documentation

Tips

• connect_to_mt5(account, password, server): Connect to MetaTrader 5 and log in.
• analyze_market_data(symbol, timeframe): Analyze market data for the specified symbol.
• place_trade(symbol, order_type, volume): Place a trade for the specified symbol.
• manage_positions(): Manage open positions.
• analyze_trading_history(days): Analyze trading history for the past specified number of days.

🔧 Technical Details

Project Structure

mcp-metatrader5-server/
├── src/
│   └── mcp_metatrader5_server/
│       ├── __init__.py
│       ├── server.py
│       ├── market_data.py
│       ├── trading.py
│       ├── main.py
│       └── cli.py
├── run.py
├── README.md
└── pyproject.toml

Build and Publish

1. Install build tools:

pip install build twine

2. Build the package:

python -m build

3. Publish to PyPI:

twine upload dist/*

📄 License

MIT License

🙏 Acknowledgments

• MetaQuotes for providing the MetaTrader 5 platform.
• FastMCP for providing the MCP server implementation.