Metatrader MCP

🚀 MetaTrader 5 MCP サーバーと Distrobox の自動化

このプロジェクトは、Distrobox コンテナ、Flask REST API、および MCP サーバーを使用して、MetaTrader 5 (MT5) のエキスパートアドバイザー (EA) の実行、最適化、および記録を完全自動化するプロセスを提供します。

✨ 主な機能

• Wine/Distrobox での MetaTrader 5：自動化されたセットアップと起動。
• Flask REST API：EA をプログラムで最適化し、実行、監視、および結果保存のエンドポイントを提供。
• MCP サーバー：取引、最適化、および結果取得のための統一インターフェース。
• 自動ドキュメント生成：最適化結果を HTML および Markdown レポートとして保存し、各 EA を個別に記録。
• Git バージョン管理：すべてのコードと設定を最初からバージョン管理。

🚀 クイックスタート

1. Distrobox コンテナのセットアップ

Distrobox コンテナを組み立てて入るには、プロジェクトのルートディレクトリから以下のコマンドを実行します。

distrobox-assemble create --file src/mt5.ini -R
distrobox-enter mt5

• src/mt5.ini を参照して、完全自動化された Distrobox の設定を確認してください。
• コンテナの作成中に、以下が自動的にインストールおよび設定されます。
  • Wine、MT5、Python3、pip、Flask、MetaTrader5、pandas、jinja2、git およびすべての必須ツール。
  • Flask API が自動的に起動します。
  • git リポジトリが初期化され、すべてのファイルがコミットされます。

2. Flask REST API

• src/mt5_flask_api.py にあります。
• API はホスト上の http://localhost:5000 で利用できます（デフォルトのポート 5000 が公開されています；src/mt5.ini を参照）。
• 例：ホストシステムから API をテストするには、以下のコマンドを実行します。

curl http://localhost:5000/optimization_status/some-id

• エンドポイント：
  • POST /optimize：最適化実行を開始します。
  • GET /optimization_status/<id>：最適化の状態を確認します。
  • GET /optimization_results/<id>：結果を取得します。
  • POST /save_results：結果を HTML/Markdown/CSV/JSON として保存します。
• 結果は ~/mt5-dev/result/manual/tuning/<EA_NAME>_tuning.html および .md に保存されます。

3. MCP サーバー

• src/mt5-server.ts を参照して、MCP サーバーの実装を確認してください。
• ツールには以下が含まれます。
  • 取引操作（get_account_info、create_order など）
  • 最適化操作（run_optimization、get_optimization_status、get_optimization_results、save_optimization_results）

4. 使用例

• コンテナを起動します（Distrobox がすべての設定を実行し、Flask API を起動します）。
• MCP サーバーを使用して最適化をトリガーし、レポートを生成します。
• ~/mt5-dev/result/manual/tuning/ 内の HTML/Markdown レポートを開いて、明確な概要を取得します。

📚 ドキュメント

デフォルトでは、すべてのログ、データ、結果、および出力は ~/mt5-dev に保存され、ポータビリティと一貫性が保証されます。
ローカル開発で任意の設定値を上書きするには、src/mt5.ini を src/mt5-dev.ini にコピーし、必要に応じてカスタマイズしてください。
src/mt5-dev.ini ファイルは Git で追跡またはプッシュされません。