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。

使用 dry_run: true 来验证作业意图，而无需点击 PIX4Dmatic UI。

批处理文件按顺序运行作业。设置 continue_on_failure: true 以在作业失败后继续。请参阅 examples/batch.example.json。

安全性

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