Andis MCP

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.txt

3.剧作家装置

# Playwright Browser installieren
playwright install chromium

安装 Node.js 依赖项（用于测试）

npm install

5. 设置环境变量

创建一个 .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

📚 更多资源

• 剧作家宣言
• 模型上下文协议
• LangGraph 文档

______________________________________________________________________

测试愉快！ 🎭