MCP Test Utils

100% AI 代码 · 人工审核

用于自动化桌面 UI 测试的 MCP 服务器。单个二进制文件 —— 无需运行时、无依赖、无需安装。

仅限 Windows x64。 计划支持 macOS 和 Linux。

为 AI 智能体提供“眼睛”和“双手”：截图、窗口管理、鼠标、键盘、UI 自动化、OCR、文件搜索。

Related MCP server: ahk-mcp

为什么使用它

AI 智能体可以触发应用程序中的操作，但无法“看到”屏幕。此服务器弥补了这一差距：

Agent triggers action → takes screenshot → sees the result →
switches window → clicks a button → verifies → writes report

完全自主，无需用户参与。

演示

10 个任务。一次录制。 在 YouTube 上观看 →

MCP Test Utils 与 Anthropic Computer Use 的对比

Claude Cowork 现在内置了 Computer Use —— Claude 可以截取屏幕截图并直观地点击界面。它无需任何设置即可工作。MCP Test Utils 采用了不同的方法：它不是通过截图猜测点击位置，而是通过 Windows API 读取实际的 UI 结构。

MCP Test Utils 更快、更精确，且单次操作成本更低。Computer Use 更易于上手且支持跨平台。它们互为补充。

平台

工具 (19)

视觉

窗口管理

输入

结构化 UI 访问

文件搜索

智能体指南

会话日志

安装

1. 从 Releases 下载二进制文件。

2. 将其添加到您的 MCP 客户端配置中。以下示例适用于 Claude Desktop — 其他客户端请参考其文档。

Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "test-utils": {
      "command": "D:\\path\\to\\mcp-test-utils.exe"
    }
  }
}

3. 重启 Claude Desktop。

4. 在聊天中尝试：“Take a screenshot” — 智能体将返回您的桌面图像。

启用日志记录和文件搜索（可选）

{
  "mcpServers": {
    "test-utils": {
      "command": "D:\\path\\to\\mcp-test-utils.exe",
      "env": {
        "MCP_LOG_DIR": "D:\\path\\to\\logs",
        "MCP_LOG_MAX_MB": "500",
        "MCP_LOG_RETAIN_DAYS": "30",
        "MCP_SEARCH_DIRS": "D:\\Projects\\app1;D:\\Projects\\app2"
      }
    }
  }
}

质量预设

截图支持可配置的质量，以平衡细节和 Token 成本：

环境变量

工作原理

MCP Test Utils 是一个通过 stdin/stdout 通信的 JSON-RPC 2.0 服务器。任何兼容 MCP 的客户端都可以启动该二进制文件，发送工具调用，并接收结构化响应（文本、base64 图像）。已在 Claude Desktop 上测试。

该服务器直接使用原生 Windows API — Win32 GDI 用于截图，SendInput 用于鼠标和键盘，UI Automation COM API 用于元素检查，WinRT Windows.Media.Ocr 用于文本识别。文件搜索使用 ripgrep 引擎 (grep-regex, grep-searcher, ignore) — 跨平台，无外部依赖。无需 PowerShell，无需外部工具，无需网络访问。

使用场景

• 自动化 QA — 智能体导航应用、点击流程、在每一步截屏、编写测试报告

• 桌面自动化 — 填写表单、在窗口间复制数据、运行工作流

• 无障碍审计 — 扫描 UI 自动化树以查找缺失的标签或角色

• 视觉回归测试 — 跨版本截图对比

• 数据提取 — 从未公开 API 的应用程序中 OCR 提取文本

• 代码搜索 — 在不离开智能体对话的情况下跨多个项目查找模式

安全性

• 仅响应来自 MCP 客户端的请求

• 不打开任何网络端口

• 不向磁盘写入任何内容（除非手动开启日志记录）

• 不向外部发送任何数据

• 截图会捕获整个屏幕 — 请确保没有敏感信息可见

• 文件搜索已沙盒化 — 仅可访问 MCP_SEARCH_DIRS 中的目录

支持我们

免费且无限制。如果您觉得它有用 — jeenyjai.github.io

许可证

版权所有 2026 JeenyJAI。保留所有权利。

🚀 由 Claude 创建