PIX4Dmatic MCP

Servidor MCP local para controlar PIX4Dmatic en Windows mediante la automatización de la GUI.

Esta primera versión implementa la capa de observación y control MVP:

• conectarse a un proceso de PIX4Dmatic ya en ejecución

• iniciar PIX4Dmatic cuando sea necesario

• enfocar la ventana de PIX4Dmatic

• capturar una captura de pantalla

• enviar teclas de acceso rápido o texto sin formato

• hacer clic en texto visible de la interfaz de usuario o rutas similares a menús

• inspeccionar el árbol de automatización de la interfaz de usuario

• abrir un archivo de proyecto existente

• iniciar el procesamiento desde los controles de procesamiento visibles

• esperar hasta que PIX4Dmatic quede inactivo

• ejecutar un trabajo JSON protegido para un proyecto existente o la sesión actual

• leer los registros recientes de PIX4Dmatic

• verificar los archivos de salida esperados

• recopilar diagnósticos

Instalación

Instalar dependencias:

python -m pip install -r requirements.txt

Instalación opcional de paquete editable:

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

Si la instalación del paquete está bloqueada por permisos locales, ejecútelo directamente desde este repositorio:

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

Ejecución

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

Para Codex u otro cliente MCP, utilice examples/mcp_config.example.json como punto de partida.

Comprobaciones locales rápidas

Se espera que PIX4Dmatic se esté ejecutando en una sesión de escritorio de Windows normal.

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

Herramientas MCP

Sesión y observación:

• pix4d_launch

• pix4d_focus

• pix4d_get_status

• pix4d_screenshot

• pix4d_get_ui_tree

Control de interfaz de usuario de bajo nivel:

• pix4d_send_hotkey

• pix4d_type_text

• pix4d_click_text

• pix4d_click_menu

Proyecto y procesamiento:

• pix4d_open_project

• pix4d_start_processing

• pix4d_wait_until_idle

• pix4d_run_job

• pix4d_run_job_object

Registros y salidas:

• pix4d_read_latest_logs

• pix4d_find_log_errors

• pix4d_check_outputs

• pix4d_collect_diagnostics

Seguridad del trabajo

pix4d_run_job_object y pix4d_run_job iniciarán el procesamiento. Un trabajo debe proporcionar project_path o establecer explícitamente use_current_session en true.

Utilice dry_run: true para validar la intención del trabajo sin hacer clic en la interfaz de usuario de PIX4Dmatic.

Seguridad

El servidor solo inicia PIX4Dmatic y no expone un ejecutor de procesos genérico. No automatiza el inicio de sesión ni los cambios de licencia.