PIX4Dmatic MCP

Lokaler MCP-Server zur Steuerung von PIX4Dmatic unter Windows mittels GUI-Automatisierung.

Diese erste Version implementiert die MVP-Beobachtungs- und Steuerungsebene:

• Verbindung zu einem bereits laufenden PIX4Dmatic-Prozess herstellen

• PIX4Dmatic bei Bedarf starten

• Das PIX4Dmatic-Fenster fokussieren

• Einen Screenshot aufnehmen

• Hotkeys oder einfachen Text senden

• Auf sichtbaren UI-Text oder menüartige Pfade klicken

• Den UI-Automatisierungsbaum untersuchen

• Eine bestehende Projektdatei öffnen

• Die Verarbeitung über sichtbare Verarbeitungssteuerelemente starten

• Warten, bis PIX4Dmatic im Leerlauf ist

• Einen geschützten JSON-Job für ein bestehendes Projekt oder die aktuelle Sitzung ausführen

• Aktuelle PIX4Dmatic-Protokolle lesen

• Erwartete Ausgabedateien überprüfen

• Diagnosedaten sammeln

Installation

Abhängigkeiten installieren:

python -m pip install -r requirements.txt

Optionale Installation als editierbares Paket:

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

Falls die Paketinstallation durch lokale Berechtigungen blockiert wird, führen Sie sie direkt aus diesem Checkout aus:

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

Ausführung

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

Für Codex oder einen anderen MCP-Client verwenden Sie examples/mcp_config.example.json als Ausgangspunkt.

Schnelle lokale Überprüfungen

Es wird erwartet, dass PIX4Dmatic in einer normalen Windows-Desktop-Sitzung ausgeführt wird.

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

MCP-Tools

Sitzung und Beobachtung:

• pix4d_launch

• pix4d_focus

• pix4d_get_status

• pix4d_screenshot

• pix4d_get_ui_tree

Low-Level-UI-Steuerung:

• pix4d_send_hotkey

• pix4d_type_text

• pix4d_click_text

• pix4d_click_menu

Projekt und Verarbeitung:

• pix4d_open_project

• pix4d_start_processing

• pix4d_wait_until_idle

• pix4d_run_job

• pix4d_run_job_object

Protokolle und Ausgaben:

• pix4d_read_latest_logs

• pix4d_find_log_errors

• pix4d_check_outputs

• pix4d_collect_diagnostics

Jobsicherheit

pix4d_run_job_object und pix4d_run_job starten die Verarbeitung. Ein Job muss entweder einen project_path bereitstellen oder use_current_session explizit auf true setzen.

Verwenden Sie dry_run: true, um die Job-Absicht zu validieren, ohne auf die PIX4Dmatic-Benutzeroberfläche zu klicken.

Sicherheit

Der Server startet nur PIX4Dmatic und stellt keinen generischen Prozess-Runner bereit. Er automatisiert weder die Anmeldung noch Lizenzänderungen.