PIX4Dmatic MCP

GUI 자동화를 통해 Windows에서 PIX4Dmatic을 제어하기 위한 로컬 MCP 서버입니다.

이 첫 번째 버전은 MVP 관찰 및 제어 계층을 구현합니다:

• 이미 실행 중인 PIX4Dmatic 프로세스에 연결

• 필요 시 PIX4Dmatic 실행

• PIX4Dmatic 창 포커스

• 스크린샷 캡처

• 단축키 또는 일반 텍스트 전송

• 표시된 UI 텍스트 또는 메뉴 경로 클릭

• UI 자동화 트리 검사

• 기존 프로젝트 파일 열기

• 표시된 처리 제어 항목에서 처리 시작

• 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

저수준 UI 제어:

• 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로 설정해야 합니다.

PIX4Dmatic UI를 클릭하지 않고 작업 의도를 검증하려면 dry_run: true를 사용하십시오.

배치 파일은 작업을 순차적으로 실행합니다. 실패한 작업 후에도 계속하려면 continue_on_failure: true를 설정하십시오. examples/batch.example.json을 참조하십시오.

안전성

서버는 PIX4Dmatic만 실행하며 일반 프로세스 실행기를 노출하지 않습니다. 로그인이나 라이선스 변경을 자동화하지 않습니다.