MetaTrader 5용 모델 컨텍스트 프로토콜(MCP) 서버로, AI 보조자가 MetaTrader 5 플랫폼과 상호작용하여 거래 및 시장 데이터 분석을 수행할 수 있게 합니다. 문서

특징

• 메타트레이더 5 단말기에 접속
• 시장 데이터 접근(심볼, 요금, 틱)
• 거래 배치 및 관리
• 거래 이력 분석
• 모델 컨텍스트 프로토콜을 통한 AI 어시스턴트와의 통합

설치

PyPI에서

출처에서

요구 사항

• uv (권장) 또는 PIP
• Python 3.11 이상
• Windows에 설치된 MetaTrader 5 터미널
• MetaTrader 5 계좌 (데모 또는 실제)

사용

퀵 스타트

서버는 기본적으로 Claude Desktop과 같은 MCP 클라이언트의 stdio 모드로 실행됩니다:

개발 모드 (HTTP)

HTTP 전송 테스트를 위해 .env 파일을 생성하세요:

그다음 다음을 실행하세요:

서버는 [[T1]에서 시작합니다.

MCP 클라이언트용 설치

방법 1: uvx 사용 (가장 간단 - 설치 필요 없음) ⭐

이 구성을 MCP 클라이언트의 설정 파일에 추가하세요:

for Claude Desktop (claude_desktop_config.json):

방법 2: FastMCP 설치 사용 (권장)

git이 저장소를 복제한 후에는 다음 명령어를 실행하세요:

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. Documentation

Features

• 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

Installation

From PyPI

uvx --from mcp-metatrader5-server mt5mcp

From Source

git clone https://github.com/Qoyyuum/mcp-metatrader5-server.git
cd mcp-metatrader5-server
uv sync
uv run mt5mcp

Requirements

• uv (recommended) or pip
• Python 3.11 or higher
• MetaTrader 5 terminal installed on Windows
• MetaTrader 5 account (demo or real)

Usage

Quick Start

The server runs in stdio mode by default for MCP clients like Claude Desktop:

uv run mt5mcp

Development Mode (HTTP)

For testing with HTTP transport, create a .env file:

MT5_MCP_TRANSPORT=http
MT5_MCP_HOST=127.0.0.1
MT5_MCP_PORT=8000

Then run:

uv run mt5mcp

The server will start at http://127.0.0.1:8000

Installing for MCP Clients

Method 1: Using uvx (Simplest - No Installation Required) ⭐

Add this configuration to your MCP client’s config file:

For Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-metatrader5-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Qoyyuum/mcp-metatrader5-server",
        "mt5mcp"
      ]
    }
  }
}

Method 2: Using FastMCP Install (Recommended)

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

After git cloning the repo, run the following commands:

For MCP JSON format

uv run fastmcp install mcp-json src/mcp_mt5/main.py

For Claude Desktop

uv run fastmcp install claude-desktop src/mcp_mt5/main.py

For Claude Code

uv run fastmcp install claude-code src/mcp_mt5/main.py

For Cursor

uv run fastmcp install cursor src/mcp_mt5/main.py

For Gemini CLI

uv run fastmcp install gemini-cli src/mcp_mt5/main.py

Method 3: Manual Configuration

Add this to your claude_desktop_config.json or whatever LLM config file:

{
  "mcpServers": {