Visual Ui Debug Agent MCP

MCP开发工具

提供方 samihalawa · 包名 visual-ui-debug-agent-mcp

开发工具 stdio · 本地进程 会话登录 社区 / 第三方 Claude DesktopClaude
查看接入方式

VUDA是一款基于MCP协议的AI视觉UI测试与调试工具,提供页面截图、工作流测试、性能监控等30多种功能,适用于自动化网页测试和视觉分析。

一句话选型结论

按资料字段整理

Visual Ui Debug Agent MCP 属于开发工具类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 78 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

UI测试JavaScript本地部署自动化测试视觉分析性能监控AI集成

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
npx visual-ui-debug-agent-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Visual Ui Debug Agent MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方samihalawa上游标注的维护方 samihalawa
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时visual-ui-debug-agent-mcp · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.3 KB
来自项目仓库与上游目录的原文,未做删改

Autonomous MCP Server for AI-Powered Visual UI Testing & Debugging
30 powerful tools for screenshots, workflows, performance, and visual analysis


VUDA是什么?

VUDA(可视化UI调试代理) 是一个MCP(模型上下文协议)服务器,它使AI模型能够使用Playwright直观地分析、测试和调试web界面。它使任何人工智能(即使是没有内置视觉的人工智能)都能检查网页、发现UI错误、测试用户工作流程并自主衡量性能。

关键能力

  • 视觉分析 -截图、分析页面结构、映射交互元素
  • 工作流测试 -通过逐步验证自动测试用户旅程
  • 性能监控 -测量负载时间,分析指标,识别瓶颈
  • API测试 -验证后端端点和响应
  • 视觉比较 -通过差异突出显示检测版本之间的UI更改
  • 控制台监控 -实时捕获错误、警告和日志

在行动中看到它

Claude Desktop using VUDA to check links and find broken pages

Validating user registration flow with step-by-step screenshots

Taking screenshots via Puppeteer MCP integration


建筑

VUDA通过MCP协议充当AI模型和web浏览器之间的桥梁。它使用Playwright实现可靠的跨浏览器自动化,并提供任何AI都能理解的结构化数据。


自动化测试工作流程

一个命令触发一个全面的网站分析——抓取所有页面,截图所有内容,验证用户流,并在几秒钟内衡量性能。


快速开始

安装```bash

Install globally via npm

npm install -g visual-ui-debug-agent-mcp

Or run directly with npx (no installation needed)

npx visual-ui-debug-agent-mcp


### 使用Claude Desktop进行配置

添加到您的Claude桌面配置(`~/Library/Application Support/Claude/claude_desktop_config.json`):```json
{
"mcpServers": {
"vuda": {
"command": "npx",
"args": ["-y", "visual-ui-debug-agent-mcp"]
}
}
}

配置其他MCP客户端```json

{
"mcpServers": {
"vuda": {
"command": "node",
"args": ["/path/to/visual-ui-debug-agent-mcp/dist/index.js"]
}
}
}


______________________________________________________________________

## 完整工具参考(30个工具)

### 可视化分析工具

|工具|说明|
|------|-------------|
| `enhanced_page_analyzer` |通过元素映射、性能指标和控制台日志进行全面的页面分析|
| `screenshot_url` |使用设备模拟捕获任何URL的高质量屏幕截图|
| `batch_screenshot_urls` |在一次操作中截图多个URL|
| `screenshot_local_files` |捕获本地HTML文件的屏幕截图|
| `visual_comparison` |比较两个页面/状态并突出视觉差异|
| `dom_inspector` |检查具有计算样式和属性的DOM元素|

### 工作流程和测试工具

|工具|说明|
|------|-------------|
| `ui_workflow_validator` |通过逐步验证测试完整的用户旅程|
| `navigation_flow_validator` |验证多步导航序列|
| `api_endpoint_tester` |使用身份验证支持测试API端点|

### 性能和监控工具

|工具|说明|
|------|-------------|
| `performance_analysis` |衡量页面加载性能和核心Web生命周期|
| `console_monitor` |监视和捕获控制台日志、错误和警告|
| `sitemap_crawler` |抓取站点地图并分析页面结构|

### 剧作家直接控制

|工具|说明|
|------|-------------|
| `playwright_navigate` |导航到URL|
| `playwright_click` |点击元素|
| `playwright_iframe_click` |单击iframe中的元素|
| `playwright_fill` |填写表单字段|
| `playwright_select` |选择下拉选项|
| `playwright_hover` |将鼠标悬停在元素上|
| `playwright_evaluate` |在页面上下文中执行JavaScript|
| `playwright_console_logs` |获取控制台输出|
| `playwright_get_visible_text` |提取可见文本内容|
| `playwright_get_visible_html` |获取渲染HTML|
| `playwright_go_back` |返回导航|
| `playwright_go_forward` |向前导航|
| `playwright_press_key` |按键盘键|
| `playwright_drag` |拖放元素|
| `playwright_screenshot` |拍摄自定义屏幕截图|

### 实用工具

|工具|说明|
|------|-------------|
| `tunnel_helper` |指导和管理Cloudflare隧道设置以进行远程调试|
| `debug_memory` |跨会话保存和检索调试上下文|

______________________________________________________________________

## 使用示例

### 拍摄屏幕截图```
Ask Claude: "Take a screenshot of https://example.com"

AI将使用 screenshot_url 以捕获页面并返回图像。

分析页面```

Ask Claude: "Analyze the UI of https://myapp.com/dashboard and find any issues"


VUDA将使用 `enhanced_page_analyzer` 要映射所有元素,请检查控制台是否有错误,并报告结果。

### 测试登录流```
Ask Claude: "Test the login flow on https://myapp.com - use test@example.com and password123"

AI将使用 ui_workflow_validator 致:

  1. 导航到登录页面
  2. 填写凭证
  3. 点击提交
  4. 验证登录成功
  5. 在每个步骤中捕获屏幕截图

比较两个版本```

Ask Claude: "Compare the homepage before and after our CSS update"


使用 `visual_comparison`,VUDA将突出显示两个状态之间的所有视觉差异。

### 监测性能```
Ask Claude: "Check the performance of our checkout page"

performance_analysis 将测量加载时间,分析核心Web生命周期,并识别瓶颈。


高级配置

环境变量```bash

Set browser options

PLAYWRIGHT_HEADLESS=true
PLAYWRIGHT_SLOW_MO=100

Debug mode

DEBUG=vuda:*


### 程序化使用```typescript
import { Server } from "@modelcontextprotocol/sdk/server/index.js";

// VUDA exposes all tools through the MCP protocol
const result = await client.callTool("enhanced_page_analyzer", {
url: "https://example.com",
includeConsole: true,
mapElements: true,
fullPage: true
});

为什么选择VUDA?

功能 VUDA 其他解决方案
MCP本地 为AI集成而构建 通常仅限REST
30专用工具 全面覆盖 工具集有限
任何AI的愿景 无内置视觉功能 需要视觉模型
自主测试 人工智能驱动的工作流程 手动脚本
跨浏览器 剧作家驱动 单浏览器
零配置 开箱即用 设置复杂

需求

  • Node.js 18岁或以上
  • npm 或 npx
  • 适用于macOS、Linux和Windows

贡献

欢迎投稿!请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

该项目根据 ISC许可证.


Built with Playwright and the Model Context Protocol
Made by @samihalawa

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Visual Ui Debug Agent MCP 怎么安装?

在客户端按下面的安装命令接入:npx visual-ui-debug-agent-mcp。对应的包名是 visual-ui-debug-agent-mcp。装完在客户端配置里引用同一个包或端点。

Visual Ui Debug Agent MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Visual Ui Debug Agent MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Visual Ui Debug Agent MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Visual Ui Debug Agent MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Visual Ui Debug Agent MCP 能提供哪些能力?

资料显示能力标签包括 JavaScript、Claude、性能监控。具体工具清单以官方文档为准。

Visual Ui Debug Agent MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Visual Ui Debug Agent MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。