MT5 MCP サーバー

MetaTrader 5 (MT5) と接続し、MCP クライアント（Claude Code / Claude Desktop 等）から マーケットデータ取得・テクニカル分析・フィボナッチ算出・売買発注を行える MCP サーバー。

仕様は docs/specification.md を参照。

必要環境

• Windows 10/11（MT5 Python API は Windows 専用）
• Python 3.12+
• MT5 ターミナルがインストール・ログイン済みであること
• 発注を使う場合: MT5 で「ツール → オプション → エキスパートアドバイザー → アルゴリズム取引を許可」を有効化

セットアップ

cd C:\Users\jun\mt5-mcp
py -m pip install -r requirements.txt
copy .env.example .env   # 必要に応じて編集

MT5 が既にログイン済みなら .env の認証情報は省略可能です。

起動

py -m mt5_mcp.server

動作確認（発注なし）

py scripts\smoke_test.py USDJPY

全ツールが [OK] になれば正常です。

MCP クライアントへの登録

claude_desktop_config.json などに以下を追加:

{
  "mcpServers": {
    "mt5": {
      "command": "py",
      "args": ["-m", "mt5_mcp.server"],
      "cwd": "C:\\Users\\jun\\mt5-mcp"
    }
  }
}

注意（発注の有効化）: 発注の有効/無効は .env の MT5_TRADE_ENABLED で決まります。 ただし OS/クライアントの環境変数が .env より優先されます（load_dotenv の既定動作）。 上記 JSON の env に "MT5_TRADE_ENABLED": "false" を書くと、.env を true にしても読み取り専用になります。 発注を有効にしたい場合は env でこの変数を指定しない（=.env に従う）か、明示的に "true" を渡してください。 サーバ起動ログに 発注ツールを登録しました (MT5_TRADE_ENABLED=true) が出れば有効です。 実際の状態は /healthz の trade_enabled でも確認できます。

リモート公開（Cloudflare トンネル）

MCP を HTTP で公開し、Cloudflare クイックトンネル経由で claude.ai / Cowork 等から接続できます。 サーバ起動とトンネルを 1つのスクリプトで立ち上げます。cloudflared が PATH 上に必要です。

claude.ai / Cowork に登録する場合（-Cowork モード）

claude.ai のカスタムコネクタは静的 Bearer トークンに非対応で、認証は OAuth のみです。 そのためトークン必須で起動すると、claude.ai が 401 を「OAuth が必要」と解釈してOAuth 認証画面を出します。 これを避けるため、認証なし＋推測困難な秘密パスで公開する -Cowork モードを使います:

.\start-remote.ps1 -Cowork

• Bearer 認証を無効化（401 を出さない＝OAuth 要求が出ない）
• パス未指定なら /mcp-<ランダム> の秘密パスを自動生成
• 表示された コネクタ URL（https://<random>.trycloudflare.com/mcp-<random>）をそのまま claude.ai / Cowork のカスタムコネクタに登録（認証は「なし」のまま）

⚠️ セキュリティ: -Cowork モードはトークンが無いため、URL（ホスト名＋秘密パス）を知る者は誰でも接続でき、MT5_TRADE_ENABLED=true なら実発注も可能です。URL は絶対に共有しないでください。トンネルを再起動すると URL は変わります。閲覧のみで十分なら .env の MT5_TRADE_ENABLED=false を推奨します。

Bearer トークンで保護する場合（既定モード／curl・Claude Code 等向け）

ヘッダーを送れるクライアント用。Authorization: Bearer <token> で認証します:

$env:MT5_MCP_TOKEN = "<長いランダム文字列>"   # 省略時は自動生成
.\start-remote.ps1

ローカル動作確認（トンネルなし・healthz/認証チェック）

powershell -ExecutionPolicy Bypass -File scripts\test_http.ps1

提供ツール（全27ツール）

カテゴリ	ツール
接続/口座	mt5_health_check, mt5_account_info, mt5_terminal_info
マーケット	mt5_symbols_list, mt5_symbol_info, mt5_quote, mt5_market_depth
ヒストリカル	mt5_ohlcv, mt5_ticks
照会	mt5_positions, mt5_orders, mt5_history_deals, mt5_history_orders
指標	mt5_indicator, mt5_indicators_batch（SMA/EMA/RSI/MACD/BB/ATR/Stochastic/ADX）
フィボナッチ	mt5_swing_points, mt5_fib_retracement, mt5_fib_expansion
複合分析	mt5_market_snapshot, mt5_analyze, mt5_confluence
発注 ⚠️	mt5_order_send, mt5_position_close, mt5_position_modify, mt5_order_modify, mt5_order_cancel, mt5_close_all

発注系は MT5_TRADE_ENABLED=true のときのみ登録されます。

安全機構（発注ガード）

1. マスタースイッチ: MT5_TRADE_ENABLED=false（既定）では発注ツール自体を登録しない
2. 二段階確認: confirm=true の無い発注は order_check によるドライラン（プレビュー）に変換
3. ロット上限: MT5_MAX_LOT 超過を拒否
4. シンボルホワイトリスト: MT5_ALLOWED_SYMBOLS
5. スリッページ上限: MT5_MAX_SLIPPAGE を強制適用
6. 監査ログ: 全発注操作を ~/.mt5_mcp/trade_audit.log に記録

⚠️ 発注機能は必ずデモ口座で十分に検証してから本番口座で使用してください。

ライセンス / 注意

本ソフトウェアは MIT License のもとで公開されています。

本ソフトウェアは無保証です。自動売買・発注に伴う損失について作者は責任を負いません。