MetaTrader 5 MCP Server & Distrobox Automation

MetaTrader 5 MCP サーバー & Distrobox 自動化

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

---

機能

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

---

クイックスタート

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

Distrobox コンテナを構築して入るには、プロジェクトルートから以下のコマンドを実行します:

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

• 完全に自動化された Distrobox 設定については、src/mt5.ini を参照してください。
• コンテナ作成時に、以下がインストールおよび設定されます:
  • 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 サーバー

• MCP サーバーの実装については、src/mt5-server.ts を参照してください。
• ツールには以下が含まれます:
  • 取引操作 (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 によって無視され、追跡またはプッシュされません。