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

Related MCP server: Smooth Operator Agent Tools

実行

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

設定

サーバーはデフォルトを自動的に読み込み、その後オプションで以下を読み取ります：

• PIX4DMATIC_MCP_CONFIG

• 現在の作業ディレクトリ内の pix4dmatic_mcp_config.json

• 現在の作業ディレクトリ内の config/pix4dmatic_mcp_config.json

便利な環境変数のオーバーライド：

• PIX4DMATIC_EXE

• PIX4DMATIC_MCP_DIAGNOSTICS_DIR

examples/pix4dmatic_mcp_config.example.json を参照してください。

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_window_screenshot

• pix4d_get_ui_tree

低レベルのUI制御：

• pix4d_send_hotkey

• pix4d_type_text

• pix4d_click_text

• pix4d_click_menu

• pix4d_list_menu_items

プロジェクトと処理：

• pix4d_open_project

• pix4d_start_processing

• pix4d_wait_until_idle

• pix4d_run_job

• pix4d_run_job_object

• pix4d_run_batch

• pix4d_run_batch_object

ログと出力：

• pix4d_read_latest_logs

• pix4d_find_log_errors

• pix4d_check_outputs

• pix4d_analyze_project

• pix4d_detect_blockers

• pix4d_collect_diagnostics

ジョブの安全性

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

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

バッチファイルはジョブを順番に実行します。失敗したジョブの後も継続するには continue_on_failure: true を設定してください。examples/batch.example.json を参照してください。

安全性

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