MT5 MCP Server

MetaTrader 5 터미널을 Claude에 연결하는 로컬 MCP 서버입니다. 시장 데이터, 계정 상태 및 내역을 읽고, 차트 스크린샷을 캡처하며, 라이브 주문을 보낼 수 있습니다.

요구 사항

1. MetaTrader 5 터미널이 실행 중이어야 합니다.

2. **도구 → 옵션 → 전문가 자문 → "알고리즘 트레이딩 허용"**이 활성화되어야 합니다.

3. 계정에 로그인되어 있어야 합니다.

터미널이 닫혀 있으면 모든 도구가 MT5 initialize failed를 반환합니다. 터미널을 열고 다시 시도하세요.

Related MCP server: metatrader-mcp

설치

uv venv --python 3.12 .venv
uv pip install --python .venv/Scripts/python.exe -r requirements.txt

그런 다음 .mcp.json의 경로를 조정하고 Claude Code를 다시 시작하세요.

도구 (20)

시장 데이터

계정

화면 캡처

screenshot은 MetaTrader5 Python API에서 비롯된 것이 아닙니다. 해당 API에는 스크린샷 함수가 전혀 없습니다. 이 기능은 Windows PrintWindow 호출(mt5_capture.py)을 기반으로 구축되었습니다. 백그라운드 창에서는 작동하지만 최소화된 창에서는 작동하지 않습니다.

전체 터미널을 캡처하려면 target='window'를, 단일 차트를 캡처하려면 target='XAUUSD,M30'를 전달하세요. 'XAUUSD'만 전달하면 해당 심볼에 대해 가장 큰 차트가 선택됩니다.

트레이딩 — 라이브

⚠️ 트레이딩 도구에는 데모/실계좌 보호 장치가 없습니다. 주문은 터미널에 로그인된 계정으로 전송됩니다. 브로커의 체결 모드는 자동으로 감지되며 필요에 따라 심볼이 Market Watch에 추가됩니다.

CLI (trade.py)

Claude 없이 동일한 도구를 명령줄에서 바로 사용할 수 있습니다:

.venv/Scripts/python.exe trade.py buy XAUUSD 0.01 --sl-points 500 --tp-points 1000
.venv/Scripts/python.exe trade.py modify 10090941191 --sl 4345.56 --tp 4360.56
.venv/Scripts/python.exe trade.py close 10090941191
.venv/Scripts/python.exe trade.py close-all --symbol XAUUSD
.venv/Scripts/python.exe trade.py positions
.venv/Scripts/python.exe trade.py calc buy XAUUSD 0.01 --close-price 4360

모든 하위 명령에 대해 trade.py --help를 실행하세요.

시간 형식

모든 시간 입력은 UTC입니다: YYYY-MM-DD, YYYY-MM-DD HH:MM 또는 YYYY-MM-DD HH:MM:SS. 출력 타임스탬프도 UTC입니다.

구성

.mcp.json의 선택적 환경 변수는 다음과 같습니다:

스모크 테스트

.venv/Scripts/python.exe -c "import mt5_mcp_server as s; print(s.mt5_status()['account'])"