WorkBuddy-QMT Bridge

WorkBuddy/MCP と大 QMT 内蔵 Python の間のネイティブなフェイルクローズ型取引ブリッジ。

重要なリスク注意

本プロジェクトはシミュレーションまたは実資金口座の注文を発動できるものであり、投資助言を構成するものではなく、利益を保証するものでもありません。デフォルトモードは OBSERVE_ONLY です。実資金でのデプロイは、必ず対象の QMT バージョン、証券会社カウンター、口座フィールド、注文返報、取消、復旧プロセスの現場受入試験を完了している必要があります。リポジトリ内のサンプルマッピングは実運用に直接使用できません。

現在のバージョン

• バージョン：0.3.0

• フェーズ：P1 LIMITED_AUTO ソフトウェア制御面完了

• MCP ツール：29 個

• Python：Worker は 3.10 以降が必要

• QMT Adapter：QMT 内蔵 Python 3.6 環境と互換

• 実行境界：127.0.0.1 のみにバインド、xtquant に依存しない

プロジェクトホームページ：https://github.com/peppaboar95/workbuddy-qmt-bridge

「P1 完了」は、ソフトウェア側の構造化認可、額度予約、状態機械、サーキットブレーカー、Adapter 再検証が実装されローカルテストを通過したことのみを意味し、任意の実資金カウンターが受入済みであることを意味しません。

Related MCP server: IBKR MCP Server

4 つのモード

SIM_SIGNAL は「シグナルのみ生成して注文しない」という意味ではありません。誤って実資金カウンターに接続した場合でも passorder を呼び出す可能性があるため、口座とカウンターを必ず人工で確認する必要があります。

セキュリティ設計

• preview_trade と submit_trade_intent の 2 フェーズコミット；

• 提出時に完全なハードリスク管理を再実行し、リスク判断フィンガープリントを比較；

• Worker と QMT Adapter の両端で口座、モード、署名、TTL、認可世代をチェック；

• LIMITED_AUTO 許可は口座、証券、アクション、戦略/ルールバージョン、取引ウィンドウ、注文タイプおよび多層額度にバインド；

• 額度のアトミック予約、単筆、累計金額、注文数、頻度、並行性、ポジションエクスポージャー、ドローダウン、連続失敗を制限；

• PRE_SUBMIT または SUBMIT_CALLED 状態は自動再送されず、未知の結果は SUBMIT_UNKNOWN を維持；

• サーキットブレーカー発動後は本機でのみ復旧可能で、安全に OBSERVE_ONLY へ戻る；

• 信用自動取引はデフォルトでオフ、新規信用負債には追加の明示的許可と現場受入試験が必要。

インストール

一般ユーザーはまず GitHub Releases からインストール ZIP、ZIP 単体ハッシュ、総ハッシュリストをダウンロードしてください：

• workbuddy-qmt-bridge-0.3.0.zip

• workbuddy-qmt-bridge-0.3.0.zip.sha256

• SHA256SUMS.txt

ハッシュを照合後 ZIP を解凍し、「初回インストールと設定.cmd」をダブルクリックします。wheel を手動インストールする必要がある場合は、以下をダウンロード：

• workbuddy_qmt_bridge-0.3.0-py3-none-any.whl

Windows PowerShell：

python -m pip install .\workbuddy_qmt_bridge-0.3.0-py3-none-any.whl
workbuddy-qmt setup

ソースから開発インストール：

git clone https://github.com/peppaboar95/workbuddy-qmt-bridge.git
cd workbuddy-qmt-bridge
python -m pip install -e .

読み取り専用から取引へ

1. setup を実行し、本機設定、鍵、Worker トークン、口座分離ディレクトリを作成；

2. 生成された qmt_adapter.py と qmt_adapter.json を対応する QMT 戦略インスタンスにデプロイ；

3. OBSERVE_ONLY を維持し、ハートビート、口座、ポジション、注文、約定、相場フィールドの収集を完了；

4. 対象のシミュレーションカウンターで P0 マッピング検証を完了し、Profile に署名；

5. SIM_SIGNAL で最小数量、注文発注、約定、取消、再起動、未知結果の復旧照合を完了；

6. 実資金シナリオではまず MANUAL_LIVE で少額受入試験を実施；

7. readiness にブロッカーがなく、戦略境界が明確な場合のみ、LIMITED_AUTO P1 許可を作成。

MANUAL_LIVE の 1〜60 分の時間認可は、取引ごとの人工承認のみを免除します。各取引は依然として再同期、プレビュー、ハードリスク管理を通過する必要があります。LIMITED_AUTO の許可は最長 720 分ですが、取引日をまたぐことはできず、完全な戦略境界と累計予算の制約を受けます。

LIMITED_AUTO P1 フロー

1. 本機で Worker と対応する Adapter を LIMITED_AUTO に切り替え；

2. check_limited_auto_readiness を呼び出し、キュー、スナップショット、ハートビート、デッドレター、SUBMIT_UNKNOWN にブロッカーがないことを確認；

3. オペレーターに完全な許可戦略を提示し、明確な確認後に authorize_limited_auto を呼び出し；

4. 自動タスクは各取引について同期、プレビュー、提出を継続実行；

5. get_limited_auto_status で残り時間、注文数、金額予算、一時停止理由を確認；

6. ヘルス、ドローダウン、連続失敗ガードがトリガーされた場合は自動一時停止；条件回復後は明示的な resume_limited_auto のみで再開可能；

7. 終了時に revoke_limited_auto を呼び出し。許可の取り消しは証券会社側の既存注文を自動的に取り消しません。

検証済みと未検証

本バージョンのローカル増分テストの対象：

• schema v1 から v2 への移行；

• 構造化 P1 許可；

• プレビュー、提出、額度のアトミック占有；

• 戦略バージョンバインド；

• 一時停止、再開、認可世代のローテーション；

• Adapter の改ざん防止再検証。

対象環境で引き続き完了が必要：

• 実 QMT と証券会社のビルド能力マトリクス；

• 実資金カウンターの注文、約定、備考、取消返報；

• Windows ACL、バックアップ、復旧、SUBMIT_UNKNOWN の訓練；

• 信用口座の 6 種類のアクション、フィールド次元、資格、額度、負債ルール；

• 少額の人工実運用受入試験。

データとプライバシー

runtime、データベース、WAL/SHM、ログ、キュー、実行ログ、署名 Profile、鍵、Worker トークン、口座番号、本機 MCP 設定は、リポジトリにコミットしたり Issue に添付したりしてはいけません。診断資料は必ず事前に匿名化してください。

ドキュメント

• リリースとインストール：docs/README-RELEASE.zh-CN.md

• P1 検証説明：docs/P1-VALIDATION.zh-CN.md

• 設定例：examples/README.md

• セキュリティポリシー：SECURITY.md

License

本プロジェクトは MIT License を採用しています。詳細は LICENSE を参照してください。