메타트레이더-mcp-서버

메타트레이더 MCP 서버

이는 AI LLM이 MetaTrader 플랫폼을 사용하여 거래할 수 있도록 Python으로 구축된 MCP(Model Context Protocol) 서버입니다.

메타트레이더 MCP 서버

부인 성명

금융 거래는 상당한 위험을 수반하며, 본 패키지 개발자는 어떠한 손실이나 이익에 대해서도 책임을 지지 않습니다. 본 패키지는 모델 컨텍스트 프로토콜(MCP)을 사용하는 AI LLM을 통한 MetaTrader 5 거래 실행을 지원하기 위한 목적으로만 제공됩니다. 본 패키지를 사용함으로써 귀하는 모든 위험을 감수하고, 개발자에게 어떠한 손해, 손실 또는 이익에 대한 법적 책임을 묻지 않거나 법적 조치를 취하지 않을 것에 동의합니다.

업데이트

2025년 5월 5일: 브로커 기반 채우기 모드 사용(0.2.5)
2025년 4월 23일: PyPi(0.2.0)에 게시됨
2025년 4월 16일: 첫 번째 마이너 버전 릴리스(0.1.0)가 출시되었습니다.

설치 가이드

작업 공간에 Python 3.10 이상 버전과 MetaTrader 5 터미널이 설치되어 있는지 확인하세요. 그런 다음 패키지를 설치하세요.

지엑스피1

그런 다음 MetaTrader 5 터미널에서 알고리즘 트레이딩을 활성화해야 합니다. Tools > Options 열고 Allow algorithmic trading 체크하세요.

Claude 데스크톱 통합

Claude Desktop 앱을 통해 거래 작업을 활성화하기 위해 이 패키지를 사용하려면 Claude Desktop 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "metatrader": {
      "command": "metatrader-mcp-server",
      "args": [
        "--login",    "<YOUR_MT5_LOGIN>",
        "--password", "<YOUR_MT5_PASSWORD>",
        "--server",   "<YOUR_MT5_SERVER>"
      ]
    }
  }
}

Open WebUI를 사용하는 다른 LLM

HTTP 서버와 Open WebUI를 사용하면 OpenAI의 GPT와 같은 다른 LLM과 함께 이 MCP 서버를 사용할 수 있습니다.

시작하려면 패키지가 설치되어 있는지 확인하세요. 그런 다음 서버를 실행하세요.

metatrader-http-server --login <YOUR_MT5_LOGIN> --password <YOUR_MT5_PASSWORD> --server <YOUR_MT5_SERVER> --host 0.0.0.0 --port 8000

로컬로 8000 포트에서 HTTP 서버를 실행하고 자동으로 MetaTrader 5 터미널을 실행합니다.

Open WebUI 설정 페이지에서 도구 메뉴로 이동합니다. 그런 다음 "도구 서버 관리"의 더하기 버튼을 클릭합니다. http://localhost:8000 (또는 설정한 포트)을 추가합니다.

WebUI 열기 - 연결 추가

모든 것이 잘된다면 이제 gpt-4o 나 o4-mini 와 같은 사용 가능한 모델을 사용하여 채팅을 통해 도구에 액세스할 수 있습니다.

WebUI 열기 - 채팅

프로젝트 로드맵

전체 버전 체크리스트는 version-checklist.md에서 확인하세요.

일	상태	완료	테스트됨
MetaTrader 5 터미널에 연결	완성된	✅	✅
MetaTrader 클라이언트 모듈 개발	완성된	✅	✅
MCP 서버 모듈 개발	완성된	✅	✅
MCP 도구 구현	완성된	✅	✅
PyPi에 게시	완성된	✅	✅
Claude Desktop 통합	완성된	✅	✅
OpenAPI 서버	완성된	✅	✅
Open WebUI 통합	완성된	✅	✅
Google ADK 통합	진행 상황에 대하여	-	-

개발자 문서

개발자의 경우 개발자 문서를 참조하세요.

metatrader-mcp-server