MetaTrader 5 MCP Server
@Qoyyuum
A Model Context Protocol (MCP) server for interacting with the MetaTrader 5 trading platform. This server provides AI assistants with tools and resources to access market data, perform trading operations, and analyze trading history.
概览
What is MetaTrader 5 MCP Server?
A Model Context Protocol (MCP) server for MetaTrader 5, allowing AI assistants to interact with the MetaTrader 5 platform for trading and market data analysis.
How to use MetaTrader 5 MCP Server?
Install the package via uvx --from mcp-metatrader5-server mt5mcp or clone the repository and run uv run mt5mcp. By default it runs in stdio mode for MCP clients like Claude Desktop. For HTTP transport (development), set environment variables MT5_MCP_TRANSPORT=http, MT5_MCP_HOST, and MT5_MCP_PORT. Configuration examples for several MCP clients (Claude Desktop, Claude Code, Cursor, Gemini CLI) are provided.
Key features of MetaTrader 5 MCP Server
- Connect to MetaTrader 5 terminal
- Access market data (symbols, rates, ticks)
- Place and manage trades
- Analyze trading history
- Integrate with AI assistants through the Model Context Protocol
Use cases of MetaTrader 5 MCP Server
- Connect an AI assistant to a MetaTrader 5 account to retrieve real-time market data
- Automate trade placement (buy/sell orders) through natural language or AI-driven analysis
- Manage and monitor open positions and active orders
- Analyze historical trades and deals for performance review
- Provide guided workflows (e.g., "connect to MT5", "analyze market data", "place trade") via built-in prompts
FAQ from MetaTrader 5 MCP Server
What are the system requirements?
Python 3.11 or higher, the MetaTrader 5 terminal installed on Windows, and a MetaTrader 5 account (demo or real).
How do I run the server in HTTP mode?
Set environment variables MT5_MCP_TRANSPORT=http, MT5_MCP_HOST=127.0.0.1, and MT5_MCP_PORT=8000 in a .env file, then run uv run mt5mcp.
What transport protocols are supported?
The server supports stdio mode (default) and HTTP transport (development mode). No authentication mechanism is described for either transport.
Where does your trading data live?
Data is accessed locally through the MetaTrader 5 terminal. The server does not store data externally; it reads market data and trade history directly from the terminal.
Can I use this server on macOS or Linux?
No. The MetaTrader 5 terminal is only officially supported on Windows, so the server requires a Windows environment.
