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 致:
- 导航到登录页面
- 填写凭证
- 点击提交
- 验证登录成功
- 在每个步骤中捕获屏幕截图
比较两个版本```
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
贡献
欢迎投稿!请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
该项目根据 ISC许可证.
Built with Playwright and the Model Context Protocol
Made by @samihalawa
