Pointframe MCP Server

Pointframe

让你的编码 Agent 测试真实的 Windows UI。
Pointframe 可让 Agent 检查你的应用、与控件交互，并通过屏幕截图和签名证据运行可重复的检查。
免费、开源，适用于 Windows x64。

设置你的 Agent  |  下载截图应用

编码 Agent： 开始前请阅读完整的 Windows 桌面验证指南。

Agent 在真实应用中检查 UI 更改

pointframe verify run 会运行你的构建和测试门禁，并针对规范中的每个场景启动已构建的应用，通过真实控件（调用、输入、检查）操作应用，然后生成包含签名证据包的判定结果：report.json、evidence/ 截图和 index.html。好的场景还会包含负向对照，即使用故意错误的预期进行检查，且该检查必须失败。

_{同一示例的 30 秒演示：失败、修复、通过、证据。点击观看。}

这是 WPF 示例通过运行时生成的真实证据截图（其参考规范也在仓库中，因此你可以重现）。

选择你的使用方式

我想……	使用	首个示例
让 Agent 能查看桌面，并可选择让它操作	MCP 服务	让 Agent 列出你的显示器；它会调用 list_displays
编写脚本来捕获、OCR 和录制，或让 Agent 必须通过验证才能继续	CLI	pointframe displays，然后运行 pointframe verify run
手动捕获、标注和录制	桌面应用	按 Print Screen

CLI 和 MCP 服务均可独立运行：两者都不需要托盘应用。捕获、OCR 和录制都只会观察。只有为某个应用完成设置后，才能与该应用的控件交互（使用 pointframe verify setup 或策略文件；参见桌面测试）。

MCP 服务为 Agent 提供的功能

11 个始终可用的工具：list_displays、list_windows、capture_monitor、capture_window、read_text_from_monitor、read_text_from_window、search_captures、get_capture、start_recording、stop_recording 和 get_recording_status。捕获结果会以内嵌图片的形式返回，同时在磁盘上保存带有 SHA-256、显示器几何信息和 DPI 的 PNG。选择启用的 desktop_* 工具可以启动获批的应用、点击、输入并检查其 UI，还能生成签名报告。详情请参阅：MCP 参考。

CLI 为脚本提供的功能

pointframe displays
pointframe windows
pointframe capture --monitor '\\.\DISPLAY1' --output .\shot.png
pointframe ocr --monitor '\\.\DISPLAY1'
pointframe record --monitor '\\.\DISPLAY1' --seconds 10 --output .\take1.mp4
pointframe verify run

发现、捕获、OCR 和录制命令无论成功还是失败，都会向标准输出写入单行 JSON 响应。退出代码 0 表示成功；1 表示运行时失败，并包含稳定的 Error.Code。命令行参数无效时，退出代码为 2，并向标准错误写入用法文本，而不是 JSON。对于其他命令，请遵循其特定的输出约定，参见 CLI 参考和 verify 文档。pointframe mcp serve 使用 MCP stdio 协议。record 需要 ffmpeg.exe。所有命令和标志参见：CLI 参考。

快速开始

设置你的 Agent

• Claude Code 插件。 从克隆的仓库中运行 claude --plugin-dir ./plugin/pointframe，即可启动 MCP 服务并添加 verify-desktop-work 技能（插件 README）。该插件尚未加入插件目录。
• 其他 MCP 客户端（Claude Desktop、Codex、Cursor、VS Code）：连接你的 MCP 客户端。
• CLI。 从最新版本下载 Pointframe.Cli-win-x64.zip，解压后在该文件夹中运行以下命令（校验和步骤： CLI 安装）。之后打开一个新终端，让用户的 Path 更改生效。接着，pointframe displays 会列出你的显示器，验证指南则介绍如何验证你自己的应用。

.\Pointframe.Cli.exe install

下载截图应用

winget install DimitarRadenkov.Pointframe

按 Print Screen 捕获一个区域，添加箭头、文本或模糊效果，然后复制、保存、固定或录制。也可以从 Releases 获取安装程序。功能、设置和快捷键参见：桌面应用指南。

常见问题

需要桌面应用吗？ 不需要。CLI 和 MCP 服务是独立的：无需托盘应用，也无需 .NET 运行时。桌面应用是供用户使用的独立截图工具。

可以在无头模式下运行吗？ 构建和测试门禁可以，包括在 CI 中运行。检查实际 UI 则需要已解锁的交互式 Windows 会话；在会话 0 中运行的 Windows 服务无法捕获用户桌面。

通过验证能说明什么？ 说明你的 spec 配置的所有门禁和场景都已通过。只有门禁的 spec 无需启动应用即可通过，因此 UI 覆盖范围仅限于场景所检查的内容。只有当 pointframe verify status 报告 fresh: true 时，才应信任验证结果。新鲜度检查 Git 可见的工作树、spec 和活动任务快照。.gitignore 忽略的文件以及 verify 自身的输出不计入检查范围。这并不能证明你的代码正确。

隐私与遥测

CLI 和 MCP 服务的官方发布版本会发送匿名使用计数（命令或工具名称、结果、时长区间、host、MCP 客户端类型、版本、随机安装 ID），绝不会发送截图、文本或路径。设置 POINTFRAME_TELEMETRY_OPTOUT=1 或 DO_NOT_TRACK=1 即可选择退出；这仅适用于 CLI 和 MCP 服务。桌面应用的官方版本会发送 PRIVACY.md 中列出的事件，该文件包含完整政策；源码构建版本不会发送任何数据。

链接

CLI 参考 | MCP 参考 | 桌面应用指南 | 验证文档 | 开发者指南 | 隐私 | 贡献 | 发布版本 | 网站

如果你觉得 Pointframe 很实用，在 GitHub 上点个星标可以帮助其他人发现它。

如果 Pointframe 为你节省了时间，不妨请我喝杯啤酒：

已迁移的章节

旧链接会跳转到以下标题。相关内容现已移至单独的文件中。

Pointframe MCP 服务

已移至 MCP 参考。

隐私政策

已移至 PRIVACY.md。

隐私与遥测

已移至 PRIVACY.md。