PIX4Dmatic MCP

Локальный MCP-сервер для управления PIX4Dmatic в Windows посредством автоматизации графического интерфейса.

Эта первая версия реализует уровень наблюдения и управления MVP:

• подключение к уже запущенному процессу PIX4Dmatic

• запуск PIX4Dmatic при необходимости

• фокусировка окна PIX4Dmatic

• создание скриншота

• отправка горячих клавиш или обычного текста

• нажатие на видимый текст интерфейса или пути меню

• проверка дерева автоматизации пользовательского интерфейса (UI Automation tree)

• открытие существующего файла проекта

• запуск обработки с помощью видимых элементов управления

• ожидание перехода 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

Низкоуровневое управление интерфейсом:

• 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.

Используйте dry_run: true для проверки намерений задания без взаимодействия с интерфейсом PIX4Dmatic.

Пакетные файлы (batch files) выполняют задания последовательно. Установите continue_on_failure: true для продолжения после неудачного выполнения задания. См. examples/batch.example.json.

Безопасность

Сервер только запускает PIX4Dmatic и не предоставляет возможности запуска произвольных процессов. Он не автоматизирует вход в систему или изменение лицензий.