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

运行

$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

底层 UI 控制：

• 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 UI。

安全性

该服务器仅启动 PIX4Dmatic，不提供通用的进程运行器。它不会自动执行登录或许可证更改。