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 erstellen

• 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

Related MCP server: Smooth Operator Agent Tools

Ausführung

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

Konfiguration

Der Server lädt automatisch Standardwerte und liest optional:

• PIX4DMATIC_MCP_CONFIG

• pix4dmatic_mcp_config.json im aktuellen Arbeitsverzeichnis

• config/pix4dmatic_mcp_config.json im aktuellen Arbeitsverzeichnis

Nützliche Umgebungsvariablen-Überschreibungen:

• PIX4DMATIC_EXE

• PIX4DMATIC_MCP_DIAGNOSTICS_DIR

Siehe examples/pix4dmatic_mcp_config.example.json.

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 läuft.

$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_window_screenshot

• pix4d_get_ui_tree

Low-Level-UI-Steuerung:

• pix4d_send_hotkey

• pix4d_type_text

• pix4d_click_text

• pix4d_click_menu

• pix4d_list_menu_items

Projekt und Verarbeitung:

• pix4d_open_project

• pix4d_start_processing

• pix4d_wait_until_idle

• pix4d_run_job

• pix4d_run_job_object

• pix4d_run_batch

• pix4d_run_batch_object

Protokolle und Ausgaben:

• pix4d_read_latest_logs

• pix4d_find_log_errors

• pix4d_check_outputs

• pix4d_analyze_project

• pix4d_detect_blockers

• pix4d_collect_diagnostics

Job-Sicherheit

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-UI zu klicken.

Batch-Dateien führen Jobs nacheinander aus. Setzen Sie continue_on_failure: true, um nach einem fehlgeschlagenen Job fortzufahren. Siehe examples/batch.example.json.

Sicherheit

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