Skip to main content
Glama
enesjakoruzh
masdevid

MT5-Quant

by masdevid
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Rust
Local

MT5-Quant

OpenSSF Scorecard CII Best Practices Rust CI crates.io License: MIT CodeQL

macOS/Linux向けMT5戦略開発用MCPサーバー。 コンパイル、バックテスト、分析、最適化、クラッシュデバッグ、MQL5エキスパートアドバイザーの管理を行う89のツールを提供します — Windowsは不要です。

You: "Backtest MyEA Jan-Mar, what caused the February drawdown?"

Claude: [compile → clean → backtest → analyze 1,847 deals]
        → Feb 14: BUY grid at L6, locking lot 1.75× base
        → Cutloss fired 17 points later
        → Recommendation: cap locking multiplier to ≤1.2×

MT5-Quantの特長

焦点: バックテストの整理、レポート作成、分析 — MT5自体にはない機能です。

MT5-Quant

その他

プラットフォーム

macOS/Linuxネイティブ

Windowsのみ

バックテストパイプライン

✅ 完全対応 (コンパイル → 実行 → 分析)

✅ MT5 Pythonパッケージ経由

ディールレベルの分析

✅ 19の分析軸、DB対応

❌

レポート整理

✅ SQLite (レポート + ディール) + 検索 + 履歴

❌

MQL5コンパイル

✅ ヘッドレス (Wine経由のMetaEditor、GUIなし)

⚠️ GUIまたはターミナル経由

最適化

✅ バックグラウンド + 結果解析 + .set生成

⚠️ ターミナルのみ、解析なし

クラッシュデバッグ

✅ Wine/MT5診断

❌

その他のツールは通常、MetaTrader5 Pythonパッケージを使用してWindows上で動作し、ターミナルの全機能を提供します。MT5-Quantはそのギャップを埋めます: バックテストレポートの整理、ディールレベルの洞察の抽出、最適化ワークフローの管理 — これらはMT5やそのPython APIではネイティブに公開されていません。

Related MCP server: mt5ctl

クイックスタート

MT5-Quantのインストール

オプションA — Cargo (推奨、Rustツールチェーンが必要)

cargo install mt5-quant --locked

オプションB — プリビルドバイナリ (ツールチェーン不要)

# macOS Apple Silicon
curl -LO https://github.com/masdevid/mt5-quant/releases/latest/download/mcp-mt5-quant-macos-arm64.tar.gz
tar xzf mcp-mt5-quant-macos-arm64.tar.gz   # → mcp-mt5-quant-macos/mt5-quant

# Linux x64
curl -LO https://github.com/masdevid/mt5-quant/releases/latest/download/mcp-mt5-quant-linux-x64.tar.gz
tar xzf mcp-mt5-quant-linux-x64.tar.gz     # → mcp-mt5-quant-linux/mt5-quant

PATH上の場所 (例: /usr/local/bin または ~/.local/bin) にバイナリを移動して、クライアントが mt5-quant として起動できるようにします。

オプションC — LLMクライアントに登録 (コピー&ペースト)

Claude Code

claude mcp add mt5-quant -- mt5-quant --stdio

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "mt5-quant": { "command": "mt5-quant", "args": ["--stdio"] } } }

Cursor — .cursor/mcp.json (Claude Desktopと同じJSON形式)

{ "mcpServers": { "mt5-quant": { "command": "mt5-quant", "args": ["--stdio"] } } }

opencode — .opencode/opencode.jsonc

{ "mcp": { "mt5-quant": { "type": "local", "command": ["mt5-quant", "--stdio"], "enabled": true } } }

Codex CLI — ~/.codex/config.toml

[mcp_servers.mt5-quant]
command = "mt5-quant"
args = ["--stdio"]

次にセットアップを完了します (Wine + MT5パスを自動検出):

bash scripts/setup.sh

ヒント: 上記のすべてをLLMコーディングエージェントに依頼することもできます: 「https://github.com/masdevid/mt5-quant からmt5-quantをインストールしてください — ダウンロードまたはビルドし、scripts/setup.shを実行してWineとMT5のパスを自動検出し、MCPサーバーとして登録してください。」

最初のバックテスト

Run a backtest on MyEA from 2025.01.01 to 2025.03.31

AIが完全なパイプラインを実行します: コンパイル → キャッシュクリア → バックテスト → 抽出 → 分析。

MCPツール (89)

コアワークフロー

ツール

説明

run_backtest

完全なパイプライン: コンパイル → クリーン → バックテスト → 抽出 → 分析

run_backtest_quick

プリコンパイル済みEAを使用したクイックバックテスト (コンパイルをスキップ)

run_backtest_only

バックテストのみ - 生のトレードを抽出するだけで、分析は行いません

launch_backtest

ファイア&フォーゲット: MT5バックテストを起動し、完了をポーリング

get_backtest_status

実行中のバックテストステータスをポーリング (MT5実行中、レポート検出、経過時間)

run_optimization

遺伝的最適化 (バックグラウンド、即座に戻る)

get_optimization_results

MT5完了後に最適化結果を解析

list_jobs

ステータス付きの全最適化ジョブを一覧表示

analyze_report

任意のレポートディレクトリから analysis.json を読み取る

compare_baseline

レポートとベースラインを比較し、勝者/敗者の判定を返す

compile_ea

MetaEditor経由でMQL5 EAをコンパイル

list_experts

MQL5/Expertsディレクトリ内の全EAを一覧表示

list_indicators

MQL5/Indicatorsディレクトリ内の全インジケーターを一覧表示

list_scripts

MQL5/Scriptsディレクトリ内の全スクリプトを一覧表示

healthcheck

サーバーのクイックヘルスチェック

list_symbols

MT5ターミナル内の利用可能な全シンボルを一覧表示

詳細分析 (個別分析)

ツール

説明

analyze_monthly_pnl

月次損益の内訳のみ

analyze_drawdown_events

ドローダウンイベントと原因のみ

analyze_top_losses

最大の損失ディールのみ

analyze_loss_sequences

連続損失パターンのみ

analyze_position_pairs

ポジション保有時間と損益のペア

analyze_direction_bias

買いと売りのパフォーマンス

analyze_streaks

勝ち/負け連続の分析

analyze_concurrent_peak

同時ポジションのピーク

対象を絞った分析にはこれらを、すべて一度に実行するには analyze_report を使用してください。

ディールレベルの分析 (新機能)

ツール

説明

list_deals

フィルター付きで個別ディールを一覧表示 (タイプ、利益範囲、ボリューム、日付)

search_deals_by_comment

ディールコメントの全文検索 (例: "Layer #3")

search_deals_by_magic

EAマジックナンバーでディールをフィルタリング

analyze_profit_distribution

利益ヒストグラム: 小/中/大の勝ちと負け

analyze_time_performance

時間帯と曜日別のパフォーマンス

analyze_hold_time_distribution

保有時間バケット + 利益との相関

analyze_layer_performance

コメントからのグリッド/マーチンゲールレイヤー分析

analyze_volume_vs_profit

ボリューム相関 + ロットサイズ別パフォーマンス

analyze_costs

手数料とスワップが収益性に与える影響

analyze_efficiency

時間/日あたりの利益、年率換算リターン、取引頻度

モニタリング

ツール

説明

verify_setup

Wine/MT5パス、Wineバージョン、EA/setファイル数を確認

get_optimization_status

バックグラウンド最適化ジョブのライブ状態を確認

list_jobs

1回の呼び出しで全最適化ジョブをコンパクトなステータスで表示

レポートとログ

ツール

説明

list_reports

主要メトリクス付きの全実行のコンパクトな表 — 完全な分析は不要

get_latest_report

オプションのエクイティチャート付きで最新レポートを取得

search_reports

EA、シンボル、日付範囲、または利益条件でレポートを検索

get_report_by_id

エクイティチャート付きでID指定のレポートを取得

get_reports_summary

集計統計: 件数、平均、合格率

get_best_reports

任意のメトリクス (プロフィットファクター、ドローダウンなど) でソートした上位N件のレポート

search_reports_by_tags

タグでレポートを検索

search_reports_by_date_range

バックテスト日付範囲でクエリ

search_reports_by_notes

レポートノートの全文検索

get_reports_by_set_file

特定の.setファイルを使用する全レポートを検索

get_comparable_reports

比較可能なレポートを検索 (同じEA/シンボル/時間足)

tail_log

任意のログの最後のN行を読み取り; filter=errors で失敗のみ表示

prune_reports

古いレポートディレクトリを削除し、最新のN件を保持 (_opt ディレクトリはスキップ)

promote_to_baseline

履歴エントリまたはレポートを baseline.json に書き込み、compare_baseline用に保存

履歴とベースライン

ツール

説明

archive_report

1つのレポートディレクトリを backtest_history.json のコンパクトなJSONエントリに変換し、オプションでソースを削除

archive_all_reports

すべてのレポートディレクトリを一括アーカイブし、オプションで削除; 最新のN件は安全に保持

get_history

フィルター (EA、シンボル、判定、利益、DD) とソートオプション付きで履歴をクエリ

annotate_history

任意の履歴エントリに判定/ノート/タグを添付

キャッシュ管理

ツール

説明

cache_status

シンボル別のMT5テスターキャッシュサイズの内訳 — クリーンアップ前に確認

clean_cache

テスターキャッシュファイルを削除; シンボル指定と dry_run をサポート

事前チェックと検証

ツール

説明

get_active_account

現在のMT5アカウントセッションを取得 (ログイン、サーバー、利用可能なシンボル)

check_symbol_data_status

シンボルが日付範囲に対して十分な履歴データを持っているか検証

check_mt5_status

MT5ターミナルがインストールされ、使用可能か確認

validate_ea_syntax

完全なコンパイルを実行せずに事前コンパイル構文チェック

デバッグと診断 (新機能)

ツール

説明

diagnose_wine

Wineのインストール、バージョン、プレフィックスの健全性を確認

get_mt5_logs

フィルタリング付きでMT5ターミナル、テスター、MetaEditorのログを取得

search_mt5_errors

ログからエラーパターン（クラッシュ、例外、アクセス違反）を検索

check_mt5_process

MT5プロセスが実行中か確認し、PID、CPU、メモリ使用量を取得

kill_mt5_process

スタックしたMT5プロセスを強制終了（wineserverにはforce=true）

check_system_resources

ディスク容量、メモリ、CPUの可用性を確認

validate_mt5_config

terminal.iniとテスター設定ファイルを検証

get_wine_prefix_info

Wineプレフィックスの詳細を取得：Windowsバージョン、インストール済みプログラム、レジストリ

get_backtest_crash_info

バックテストの失敗を調査：不完全なマーカー、欠落したdeals.csv、エラー

check_update

MT5-Quantの新しいバージョンが利用可能か確認

update

MT5-Quantを最新リリースに更新

プロジェクト管理

ツール

説明

init_project

テンプレート（scalper/swing/grid/basic）付きで新しいMQL5プロジェクトを雛形生成

create_set_template

EA入力変数から.setパラメータファイルを生成

export_report

バックテストレポートをCSV、JSON、またはMarkdownにエクスポート

履歴と比較

ツール

説明

get_backtest_history

EA/シンボルの全バックテストをサマリーメトリクス付きで一覧表示

compare_backtests

2件以上のバックテスト結果を分析付きで横並びに比較

.setファイル — 読み取り / 書き込み

ツール

説明

list_set_files

テスタープロファイルディレクトリ内の全.setファイルをスイープ統計と組み合わせ数付きで一覧表示

read_set_file

UTF-16LEの.setファイルを解析 → 構造化されたJSONパラメータに変換

write_set_file

完全なパラメータ辞書 → chmod 444付きのUTF-16LE .setに書き込み

patch_set_file

特定のパラメータをその場で更新し、差分を返す — 読み取り→編集→書き込みを置き換え

clone_set_file

1回の呼び出しでオプションの上書きを適用しつつ.setを新しいパスにコピー

.setファイル — 分析と生成

ツール

説明

describe_sweep

スイープされたパラメータ、値のカウント、最適化の総組み合わせ数

diff_set_files

2つの.setファイルの横並び差分 — 変更されたパラメータのみ返却

set_from_optimization

get_optimization_resultsのパラメータからクリーンなバックテスト用.setを生成；必要に応じてスイープを絞り込み

検索と発見

ツール

説明

search_experts

全ディレクトリから名前パターンでEAを検索

search_indicators

名前パターンでインジケーターを検索

search_scripts

名前パターンでスクリプトを検索

copy_indicator_to_project

インジケーターをプロジェクトディレクトリにコピー

copy_script_to_project

スクリプトをプロジェクトディレクトリにコピー

完全なスキーマ: docs/MCP_TOOLS.md

トラブルシューティング

最初にLLMからverify_setupを実行してください — すべてのパスをチェックし、実行可能なヒントを返します。

バックテスト/コンパイル/最適化中のクラッシュや原因不明の失敗には：

  • diagnose_wine — Wineのインストールとプレフィックスの健全性を確認

  • search_mt5_errors — ログからクラッシュの原因を特定

  • check_mt5_process + kill_mt5_process — スタックしたプロセスを検出して強制終了

  • get_backtest_crash_info — 失敗したバックテストレポートを調査

完全なトラブルシューティングガイド →

ドキュメント

ドキュメント

説明

QUICKSTART

ステップバイステップのインストール、セットアップ、最初のバックテスト

MCP_TOOLS

全90ツールの完全な入出力スキーマ

CONFIG

設定リファレンス（config/mt5-quant.yaml）

ARCHITECTURE

設計原則と内部モジュール構成

REMOTE_AGENTS

Wine経由でLinuxエージェント全体に最適化を分散

TROUBLESHOOTING

Wine、MT5、バックテスト向けのプラットフォーム別修正

推奨読書順の完全なインデックス: docs/INDEX.md

謝辞

MT5-Quantは、優れたオープンソースプロジェクトの上に成り立っています：

  • Rust — ゼロコスト抽象化、メモリ安全性、恐れのない並行性を実用的にする言語

  • Tokio — すべての並行操作を支える非同期ランタイム

  • Wine — WindowsライセンスなしでmacOSとLinuxでのMT5実行を可能にする

  • MetaTrader 5 — MetaQuotesの取引プラットフォーム（MetaQuotes Software Corp.の商標）

  • rusqlite — Rust向けの使いやすいSQLiteバインディング

  • serde — 設定とレポート処理を簡単にするシリアライゼーションフレームワーク

  • scraper — MT5レポート抽出のためのHTMLパース

  • tempfile — 安全な一時ファイル処理

AIを活用した開発ワークフローを可能にする標準を定義してくれたAnthropicのModel Context Protocol（MCP）チームに特別な感謝を捧げます。

免責事項

投資助言ではありません。 MT5-Quantはアルゴリズム取引戦略のための開発・分析ツールです。投資助言、取引推奨、または利益の保証を提供するものではありません。すべてのバックテスト結果は過去のシミュレーションであり、将来のパフォーマンスを保証するものではありません。

自己責任でご利用ください。 金融商品の取引には重大な損失のリスクが伴います。MT5-Quantの作者および貢献者は、以下について一切の責任を負いません：

  • 本ツールで開発またはテストされた戦略を使用して生じた取引損失

  • バックテスト操作によるデータの損失または破損

  • バグ、エラー、または誤った分析結果

  • システムクラッシュ、Wine互換性の問題、またはMT5の障害

ソフトウェアの保証。 本ソフトウェアは「現状のまま」提供され、商品性、特定目的への適合性、非侵害性の保証を含むがこれらに限定されない、明示または黙示のいかなる種類の保証もありません。完全な条件についてはLICENSEを参照してください。

サードパーティソフトウェア。 MT5-QuantはMetaTrader 5、Wine、その他のサードパーティソフトウェアと連携します。ユーザーはこれらの依存関係について、該当するすべてのライセンスと利用規約を遵守する責任があります。MetaTraderはMetaQuotes Software Corp.の商標です。MT5-QuantはMetaQuotesと提携しておらず、その承認や後援も受けていません。

規制遵守。 ユーザーは、自身の取引活動が居住地域の該当する金融規制に準拠していることを確認する責任があります。自動取引は一部の地域で制限されたり、ライセンスが必要になる場合があります。

ライセンス

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-metaeditor

    CtpN3m01
    A
    license
    Not graded
    quality
    C
    maintenance
    Connects MCP clients to MetaTrader 5 MetaEditor on Linux via Wine, enabling automated MQL5 development workflows including code editing, compilation of EAs/indicators, and strategy backtesting.
    5
    MIT

  • mt5ctl

    Chust-dev
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server for operating headless MetaTrader 5 terminals — over SSH, from your agent.
    MIT

  • mt5-mcp

    alikhande70
    A
    license
    Not graded
    quality
    C
    maintenance
    A local-first MCP server that bridges AI coding agents with MetaTrader 5 for inspection, market data, MQL5 development, compiling, Strategy Tester review, workspace sync, logs, audit trails, demo trading, and carefully gated live trading.
    MIT

  • FullMt5McpByLeo

    TradeSystemsNique
    F
    license
    Not graded
    quality
    D
    maintenance
    Universal MCP server that enables AI assistants to control MetaTrader 5 directly, executing trades, managing data, and automating MT5 operations through natural language.
    2
    -