AndisMCP-剧作家测试生成器
一个模型上下文协议 （MCP） 服务器，用于自动生成具有 AI 支持的 Playwright TypeScript 测试。
📋 概述
AndisMCP是一款智能服务器，可抓取网站，创建页面对象模型并自动生成Playwright测试。该工具使用 LangGraph 和 OpenAI 创建高质量、可维护的测试套件。
✨ 特性
- 🔍 网站爬行自动检测和分析网站
- 🎯 UI 模型提取识别按钮、表单、链接和其他 UI 元素
- 📝 页面对象模型生成自动创建 POM
- 🧪 测试生成智能创建 Playwright TypeScript 测试
- 🔧 语法修复自动更正语法错误
- ✅ 验证检查生成的 POM
📦 条件
- python: >= 3.10
- Node.js：>= 18.x（Playwright）
- OpenAI API密钥针对 AI 支持的一代
🚀 安装
1.知识库klonen
git clone https://github.com/Andrejtr4/AndisMCP.git
cd DerBesteMCP安装Python依赖关系
# Virtuelle Umgebung erstellen (empfohlen)
python3 -m venv venv
source venv/bin/activate # Auf macOS/Linux
# Dependencies installieren
pip install -r requirements.txt3.剧作家装置
# Playwright Browser installieren
playwright install chromium安装 Node.js 依赖项（用于测试）
npm install5. 设置环境变量
创建一个 .env项目目录中的文件 ：
# .env
OPENAI_API_KEY=dein-openai-api-key🎮 使用
Als MCP服务器已启动
该服务器可以作为 MCP 服务器启动，并提供以下工具：
python src/mcp_server.py可用工具
1. generate_tests_full 完整的管道
抓取网站并生成完整的测试套件。
{
"url": "https://example.com",
"max_pages": 10,
"stories": "Optional: User Stories zur Testgenerierung"
}2. crawl_links -链接被抓取
查看网站上的所有链接。
{
"base_url": "https://example.com"
}3. scan_网站 - 网站扫描
分析URL的结构。
{
"url": "https://example.com/page"
}4. 提取模型 - UI 模型提取
提取UI元素（按钮，表单等）。
{
"url": "https://example.com/page",
"name": "LoginPage"
}5. generate_pom 创建页面对象模型
从 UI 模型创建 POM。
{
"name": "LoginPage",
"model": { /* UI-Modell */ }
}6. verify_com 验证 POM
检查 POM 文件。
{
"pom_path": "tests/pages/LoginPage.ts"
}7. 维修文件 修复语法
修复生成的文件中的语法错误。
{
"file_path": "tests/pages/LoginPage.ts",
"error_message": "Optional: Fehlermeldung"
}8. 快速启动 -Schnell演示
生成测试 the-internet.herokuapp.com （2页）。
{}📝 Playwright 测试
测试生成后，可以运行测试：
# Alle Tests ausführen
npm test
# Tests mit UI
npm run test:ui
# Tests im Browser (headed mode)
npm run test:headed
# Tests debuggen
npm run test:debug🏗️ 项目结构
DerBesteMCP/
├── src/
│ ├── mcp_server.py # Haupt-MCP-Server
│ ├── core/ # Kernfunktionalität
│ │ ├── pipeline.py # Hauptpipeline
│ │ ├── config.py # Konfiguration
│ │ ├── schemas.py # Datenstrukturen
│ │ └── prompts.py # LLM-Prompts
│ └── tools/ # MCP Tools
│ ├── crawl_links.py
│ ├── scan_site.py
│ ├── extract_model.py
│ ├── generate_pom.py
│ ├── generate_tests_ts.py
│ ├── verify_pom.py
│ └── repair.py
├── tests/ # Generierte Tests
├── playwright.config.ts # Playwright-Konfiguration
├── package.json # Node.js Dependencies
├── requirements.txt # Python Dependencies
└── pyproject.toml # Python Projekt-Konfiguration🔧 配置
剧作家形象
Playwright 配置位于 playwright.config.ts在这里，您可以调整浏览器，超时和其他设置。
管道配置
管道设置可以在 src/core/config.py 适应：
- LLM模型（标准：GPT-4）
- 输出目录
- 超时设置
🤝 与 Claude Desktop / VS Code 集成
要将 AndisMCP 与 Claude Desktop 或 VS Code 配合使用，请将服务器添加到 MCP 配置中：
{
"mcpServers": {
"andismcp": {
"command": "python",
"args": ["/pfad/zu/DerBesteMCP/src/mcp_server.py"],
"env": {
"OPENAI_API_KEY": "dein-api-key"
}
}
}
}📄 许可证
国际协调委员会
👤 作者
安德烈亚斯
🐛 故障排除
“找不到剧作家”
playwright install chromium“OpenAI API错误”
检查您的 API 密钥是否在 .env文件设置正确。
“找不到模块”
pip install -r requirements.txt📚 更多资源
______________________________________________________________________
测试愉快！ 🎭