PIX4Dmatic MCP

GUI自動化を通じてWindows上のPIX4Dmaticを制御するためのローカルMCPサーバー。

この最初のバージョンでは、MVP（実用最小限の製品）の監視および制御レイヤーを実装しています：

• 既に実行中のPIX4Dmaticプロセスへの接続

• 必要に応じたPIX4Dmaticの起動

• PIX4Dmaticウィンドウのフォーカス

• スクリーンショットのキャプチャ

• ホットキーまたはプレーンテキストの送信

• 表示されているUIテキストやメニューのようなパスのクリック

• UIオートメーションツリーの検査

• 既存のプロジェクトファイルを開く

• 表示されている処理コントロールからの処理開始

• PIX4Dmaticがアイドル状態になるまで待機

• 既存のプロジェクトまたは現在のセッションに対する保護されたJSONジョブの実行

• 最近のPIX4Dmaticログの読み取り

• 期待される出力ファイルの確認

• 診断情報の収集

インストール

依存関係のインストール：

python -m pip install -r requirements.txt

オプションの編集可能なパッケージインストール：

python -m pip install -e . --no-build-isolation

ローカルの権限によってパッケージのインストールがブロックされる場合は、このチェックアウトから直接実行してください：

$env:PYTHONPATH = "src"
python -m pix4dmatic_mcp.server

実行

$env:PYTHONPATH = "src"
python -m pix4dmatic_mcp.server

Codexやその他のMCPクライアントの場合は、examples/mcp_config.example.jsonを出発点として使用してください。

クイックローカルチェック

PIX4Dmaticは、通常のWindowsデスクトップセッションで実行されている必要があります。

$env:PYTHONPATH = "src"
python scripts/test_status.py
python scripts/inspect_ui.py

MCPツール

セッションと監視：

• pix4d_launch

• pix4d_focus

• pix4d_get_status

• pix4d_screenshot

• pix4d_get_ui_tree

低レベルのUI制御：

• pix4d_send_hotkey

• pix4d_type_text

• pix4d_click_text

• pix4d_click_menu

プロジェクトと処理：

• pix4d_open_project

• pix4d_start_processing

• pix4d_wait_until_idle

• pix4d_run_job

• pix4d_run_job_object

ログと出力：

• pix4d_read_latest_logs

• pix4d_find_log_errors

• pix4d_check_outputs

• pix4d_collect_diagnostics

ジョブの安全性

pix4d_run_job_objectおよびpix4d_run_jobは処理を開始します。ジョブにはproject_pathを提供するか、use_current_sessionを明示的にtrueに設定する必要があります。

PIX4DmaticのUIをクリックせずにジョブの意図を検証するには、dry_run: trueを使用してください。

安全性

このサーバーはPIX4Dmaticを起動するだけであり、汎用的なプロセスランナーを公開するものではありません。ログインやライセンスの変更を自動化することはありません。