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

Запуск

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

Для 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_get_ui_tree

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

• pix4d_send_hotkey

• pix4d_type_text

• pix4d_click_text

• pix4d_click_menu

Проект и обработка:

• pix4d_open_project

• pix4d_start_processing

• pix4d_wait_until_idle

• pix4d_run_job

• pix4d_run_job_object

Логи и результаты:

• pix4d_read_latest_logs

• pix4d_find_log_errors

• pix4d_check_outputs

• pix4d_collect_diagnostics

Безопасность заданий

pix4d_run_job_object и pix4d_run_job запустят процесс обработки. Задание должно либо предоставлять project_path, либо явно устанавливать use_current_session в значение true.

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

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

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