MT5 MCP サーバー

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'])"