UniAuto MCP服务器
通用测试自动化MCP服务器，用于web和桌面自动化，具有自愈功能和AI集成。
尖端功能
UniAuto MCP Server融合了几个前沿和未来主义的功能，使其处于测试自动化技术的前沿：
1.多层自愈自动化
服务器的5层自愈机制是革命性的，它使用了复杂的级联恢复策略：
- 基于存储库的备选选择器
- 基于角色的可访问性选择器
- 动态宽松选择器生成
- 基于DOM的视觉元素匹配与图像识别
- 上下文文本邻近检测
这种多策略方法创建了非常有弹性的测试，即使在重大的UI大修中也能幸存下来。
2.人工智能驱动的测试生成和维护
与Claude和其他LLM的集成可以实现：
- 自然语言测试创建（“自动结账流程”）
- 使用适当的选择器自动生成测试步骤
- 智能响应解析，将AI输出转化为可执行命令
- 视觉上下文解释（使用屏幕截图作为输入）
- 在多个框架（Playwright、Cypress、Jest等）中自动生成测试代码
- 支持各种测试风格（BDD、TDD）和输出格式
- 智能测试创建的应用结构分析
3.MCP（模型上下文协议）集成
MCP的实施尤其具有前瞻性：
- 允许AI助手直接控制测试基础设施
- 展示自动化操作的标准化API
- 实现与Smithery.ai和其他ai编排平台的无缝集成
- 在LLM和web/桌面自动化之间建立桥梁
4.统一Web+桌面自动化
在单个框架内集成web测试（通过Playwright）和桌面自动化提供了：
- 跨域测试能力
- 能够测试跨浏览器和本机应用程序的流
- 不同应用程序类型的API一致
5.视觉智能
视觉匹配的实现提供了：
- 按外观而非结构识别元素
- 即使DOM元素完全更改，也要测试连续性
- 像素完美比较功能
核心功能
- 使用Playwright实现Web自动化（支持多浏览器）
- 桌面自动化功能
- 用于弹性测试自动化的自愈选择器
- 用于测试生成的AI集成（支持Claude和其他模型）
- 在多种框架和样式中自动生成测试代码
- 与人工智能助手兼容的MCP（模型上下文协议）
- 测试用例管理和执行历史
- 视觉元素匹配
对测试自动化生态系统的影响
UniAuto MCP Server具有改变测试自动化格局的潜力：
1.降低维护成本
自愈能力大大降低了测试自动化中的头号痛点——维护成本。研究表明，组织将30-40%的测试时间花在测试维护上。UniAuto可以将这一比例降低70-80%，从而将QA资源用于更具战略性的工作。
2.测试自动化的民主化
人工智能集成允许非技术利益相关者使用自然语言创建测试，从而可能通过以下方式扩大测试自动化的采用：
- 允许产品经理直接指定验收测试
- 使业务分析师无需编码即可验证功能
- 减少测试创建所需的专业技能
3.韧性革命
通过解决现代自动化中的脆性问题，UniAuto将整个生态系统转向以弹性为中心的测试，而不是以选择器为中心的检测。这种范式转变从根本上改变了测试的编写和评估方式。
4.测试中的AI放大
作为与Claude和其他型号兼容的MCP系统，UniAuto将自动化定位为“人工智能原生”技术，为以下方面奠定了基础：
- 人工智能驱动的探索性测试
- 自主测试维护
- 基于应用程序更改的智能测试优先级
- 面向利益相关者的自然语言测试报告
5.跨域测试标准
通过将web和桌面测试统一到一个框架下，UniAuto帮助建立了端到端测试的新标准，超越了目前针对不同应用程序类型的孤立方法。
安装
# Clone the repository
git clone https://github.com/yourusername/uniauto-mcp-server.git
cd uniauto-mcp-server
# Install dependencies
npm install
# Install Playwright browsers
npx playwright install
# Create environment file
cp .env.example .env配置
编辑 .env 配置服务器的文件：
# Server Configuration
PORT=3000
NODE_ENV=development
# Database (optional)
MONGODB_URI=mongodb://localhost:27017/uniauto
# Claude Configuration (required for AI processing)
CLAUDE_API_KEY=your_claude_api_key
CLAUDE_MODEL=claude-3-7-sonnet-20240229Claude API集成
UniAuto MCP Server使用官方的Anthropic SDK与Claude集成：
const Anthropic = require('@anthropic-ai/sdk');
const anthropic = new Anthropic({
apiKey: process.env.CLAUDE_API_KEY,
});
const response = await anthropic.messages.create({
model: "claude-3-7-sonnet-20240229",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello, Claude" }],
});用法
# Start the server in development mode
npm run dev
# Start the server in production mode
npm startAPI终点
健康检查
GET /api/health-检查服务器状态
自动化命令
POST /api/execute-执行自动化命令
测试用例管理
POST /api/test-cases-创建测试用例GET /api/test-cases-获取所有测试用例GET /api/test-cases/:id-按ID获取测试用例PUT /api/test-cases/:id-更新测试用例DELETE /api/test-cases/:id-删除测试用例
人工智能集成
POST /api/ai/process-使用AI的过程自动化任务
测试生成
POST /api/generate-tests-为应用程序生成测试用例POST /api/generate-full-suite-生成一个包含多种测试类型的完整测试套件POST /api/scaffold-project-搭建完整的测试项目结构GET /api/test-frameworks-获取可用的测试框架、样式和格式
高级测试
POST /api/visual-compare-将页面或元素与基线图像进行比较POST /api/accessibility-test-在页面上执行可访问性测试POST /api/performance-test-在页面上执行性能测试POST /api/network-trace-跟踪API测试的网络活动POST /api/test-suite-运行一个全面的测试套件
MCP集成
POST /api/mcp/invoke-MCP兼容命令执行GET /api/mcp/manifest-获取MCP清单
MCP集成
该服务器与Claude等人工智能助手使用的模型上下文协议（MCP）兼容。要将其与Claude或其他AI模型一起使用：
- 启动服务器
- 在AI助手中注册MCP服务器
- 人工智能现在可以通过MCP协议使用自动化功能
Smithery.ai集成
UniAuto MCP服务器与 Smithery.ai，使与Claude 3.7和其他人工智能助手的连接变得容易：
为了与AI助手无缝集成，您可以使用Smithery.AI：
# Install Smithery CLI
npm install -g @smithery/cli
# Connect UniAuto to Smithery
smithery connect uniauto-mcp-server
# Connect to an AI assistant
smithery connect --assistant claude连接后，您可以使用Claude Code、Claude Web、带Claude扩展的VSCode或Cursor来控制UniAuto进行自动测试。
请参阅 Smithery安装指南 详细说明。
AI助手集成
UniAuto可与各种AI助手配合使用：
测试生成能力
UniAuto MCP Server可以自动生成各种框架和样式的测试代码：
- 多个框架：为Playwright、Cypress、Jest、Selenium、WebDriver IO等生成测试
- 测试样式：支持BDD、TDD和其他测试方法
- 输出格式：JavaScript、TypeScript、Python、Java、C#和Ruby
- 应用分析：用于上下文感知测试生成的智能应用程序结构分析
- 项目脚手架：使用配置文件生成完整的测试项目
- Claude AI集成：使用Claude 3.7生成高质量、可维护的测试代码
- MCP集成：通过模型上下文协议公开的所有测试生成功能
先进的测试能力
UniAuto MCP Server提供全面的测试功能，而不仅仅是生成测试代码：
- 目视检测：将页面或元素截图与具有可配置阈值的基线进行比较
- 可访问性测试：检查WCAG是否符合有关问题和建议修复的详细报告
- 性能测试：测量关键的web性能指标，如加载时间、FCP、LCP和资源
- 网络跟踪：监视API调用、分析响应并验证网络行为
- 并行执行：同时运行多个测试类型以减少总执行时间
- 综合测试套件：将测试执行与统一报告相结合
请参阅 测试生成指南 了解API的详细文档和示例。
自我修复能力
服务器对自愈选择器使用了几种策略：
- 备选选择器存储库
- 基于角色的选择器（特定于剧作家）
- 放宽CSS选择器生成
- 使用Playwright的内置功能进行视觉元素匹配
- 最近的基于文本的元素查找
剧作家福利
Playwright为测试自动化提供了几个优势：
- 跨浏览器支持：适用于Chromium、Firefox和WebKit
- 现代网络支持：更好地处理Shadow DOM、iframe和web组件
- 强大的选择器：基于角色的选择器、基于文本的选择和CSS/XPath支持
- 自动等待：在操作之前自动等待元素准备就绪
- 可靠的行动：通过重试和定时管理实现更可靠的元素交互
- 网络控制：拦截和修改网络请求
- 无头和有头模式：需要时进行可视化调试
贡献
欢迎投稿！请随时提交拉取请求。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
