mcpField
P
python-workspace

python-workspace

github.com/terrylica開発2129 回インストール1 日前に更新
リポジトリ

python-workspace について

MetaTrader 5 のデータや MQL5 インジケーターを扱う開発者向けのワークスペーススキルです。データの自動エクスポートと MQL5 から Python への変換検証を案内し、精度確認や制約も説明します。

主な機能

  1. 01ヘッドレスでの市場データ出力
  2. 02OHLCV、RSI、SMA データの取得
  3. 03Python インジケーター計算の検証
  4. 04検証結果に基づく変換の反復
  5. 05ワークフローの制約とトラブル対応

活用シーン

  1. 01GUI を使わず MetaTrader 5 の市場データを出力
  2. 02MQL5 インジケーターを Python に変換
  3. 03Python の指標結果を MQL5 の参照値と照合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/terrylica/cc-skills --skill python-workspace

インストール後、Claude Code で/python-workspaceを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
capabilities-detailed.md
evolution-log.md
troubleshooting-errors.md
validation-metrics.md
workflows-complete.md

詳細

MQL5-Python 翻訳ワークスペーススキル

自律的な検証と自己修正により、MQL5 インジケーターをシームレスに Python へ翻訳します。

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある、パラメーターがずれている、または回避策が必要だった場合は、先送りせずにこのファイルをすぐに修正してください。実際に再現できる問題がある場合にのみ更新してください。

このスキルを使用する場面

次のことを行いたい場合に、このスキルを使用してください。

  • MetaTrader 5 から市場データやインジケーターの値をエクスポートする
  • MQL5 インジケーターを Python 実装に翻訳する
  • MQL5 の参照値と照合して Python インジケーターの精度を検証する
  • MQL5-Python ワークフローの機能と制限を理解する
  • よくある翻訳の問題をトラブルシューティングする

起動フレーズ：「MQL5」、「MetaTrader」、「indicator translation」、「Python validation」、「export data」、「mql5-crossover workspace」

主な目的

主なテーマ：次の方法により、MQL5-Python 翻訳を可能な限りシームレスにします。

  1. 自律型ワークフロー（ヘッドレスエクスポート、CLI コンパイル、自動検証）
  2. 検証に基づく反復（すべての作業で >=0.999 の相関をゲートとして使用）
  3. 自己修正（失敗事例を記録し、今後のミスを防止）
  4. 明確な境界（できることとできないこと、および代替手段）

プロジェクトルート：~/Library/Application Support/CrossOver/Bottles/MetaTrader 5/drive_c

ワークスペースの機能一覧

このワークスペースでできること
1. ヘッドレスによる市場データの自動エクスポート（v3.0.0）

ステータス：本番運用可能（0.999920 の相関を検証済み）

機能：

  • 任意の銘柄／時間足から OHLCV データと組み込みインジケーター（RSI、SMA）を取得します
  • Wine の Python と MetaTrader5 API を介して完全なヘッドレス実行が可能です
  • GUI の初期化は不要です（コールドスタートに対応）
  • 実行時間：5000 本のバーで 6～8 秒

コマンド例：

CX_BOTTLE="MetaTrader 5" \
WINEPREFIX="$HOME/Library/Application Support/CrossOver/Bottles/MetaTrader 5" \
wine "C:\\Program Files\\Python312\\python.exe" \
  "C:\\users\\crossover\\export_aligned.py" \
  --symbol EURUSD --period M1 --bars 5000

使用する場面：GUI 操作なしで市場データを自動エクスポートする必要がある場合

制限事項：カスタムインジケーターのバッファにはアクセスできません（API の制限）

参照先：/docs/guides/WINE_PYTHON_EXECUTION.md

参考ドキュメント

詳細については、以下を参照してください。

トラブルシューティング

問題原因解決策
Wine Python が見つからないCrossOver／Wine がインストールされていないCrossOver をインストールし、ボトルのパスを確認してください
MT5 API の接続に失敗するMetaTrader が起動していないエクスポートを実行する前に MetaTrader 5 を起動してください
相関が 0.999 を下回るインジケーターが一致していないウォームアップ期間を確認し、計算の位置合わせを確認してください
カスタムインジケーターが動作しないAPI の制限Python API ではなく、MT5 から CSV をエクスポートしてください
UnicodeDecodeErrorWindows パスのエンコーディングWine で Windows パスに raw 文字列を使用してください
銘柄が見つからない銘柄の形式が正しくないMT5 の正確な銘柄名を使用してください（例：EUR/USD ではなく EURUSD）
エクスポートがタイムアウトする要求したバー数が多すぎるバー数を減らしてください。デフォルトの 5000 は安全です
アクセスが拒否されるWine のプレフィックスが正しくないWINEPREFIX に正しい CrossOver ボトルのパスを設定してください

実行後の振り返り

このスキルの実行後、終了する前に次の点を確認してください。

  1. コマンドは成功しましたか？ — 成功していない場合は、失敗の原因となった手順またはエラーテーブルを修正します。
  2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースに変更があった場合は、使用例とパラメーターテーブルを更新して一致させます。
  3. 回避策が必要でしたか？ — 別のフラグや追加手順など、その場で工夫する必要があった場合は、次回の実行で同じ回避策が不要になるよう、この SKILL.md を更新します。

問題が実際に発生し、再現可能な場合にのみ更新してください。推測で更新しないでください。

コメント

Markdown 対応