Metatrader MCP

🚀 MetaTrader 5 MCP 服務器與 Distrobox 自動化

本項目提供了一套完全自動化的流程，用於運行、優化並記錄 MetaTrader 5 (MT5) 專家顧問 (EA)。藉助 Distrobox 容器、Flask REST API 以及 MCP 服務器，能高效完成相關操作。

🚀 快速開始

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

• 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 報告以獲取清晰概述。

✨ 主要特性

• MetaTrader 5 在 Wine/Distrobox 中：實現自動化設置和啟動。
• Flask REST API：可程序化優化 EA，提供運行、監控和保存結果的端點。
• MCP 服務器：提供統一接口用於交易、優化和結果檢索。
• 自動文檔生成：優化結果以 HTML 和 Markdown 報告的形式保存，每個 EA 都有獨立記錄。
• Git 版本控制：從一開始就對所有代碼和配置進行版本化。

📚 詳細文檔

工作目錄與配置

默認情況下，所有日誌、數據、結果和輸出存儲在 ~/mt5-dev 中，確保了便攜性和一致性。
若要覆蓋任何配置值以進行本地開發，請複製 src/mt5.ini 到 src/mt5-dev.ini 並按需自定義。
src/mt5-dev.ini 文件未被 Git 跟蹤或推送。