Skip to main content
Glama
deenesjakoruzh
bisminizzar84

AI QA Agent MCP

by bisminizzar84
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

AI QA Agent MCP

Playwright와 Node.js로 구축된 MCP 지원 QA 자동화 프레임워크로, Model Context Protocol(MCP) 서버를 통해 UI 및 API 자동화 테스트를 실행합니다.

이 프로젝트는 기존의 테스트 자동화를 재사용 가능한 MCP 도구로 노출하는 방법을 보여주며, MCP 호환 클라이언트가 테스트 스위트를 실행하고 구조화된 테스트 결과를 받을 수 있게 합니다.

🚀 기능

  • Playwright UI 자동화

  • Playwright 기반 API 테스트

  • Page Object Model (POM)

  • MCP 서버 통합

  • MCP 도구 기반 테스트 실행

  • 구조화된 JSON 테스트 결과

  • 로그인, 인벤토리 및 체크아웃 테스트 커버리지

  • 긍정 및 부정 테스트 시나리오

  • 회귀 테스트 실행

  • 환경 기반 구성

  • HTML 테스트 리포트

  • 실패 시 스크린샷

  • GitHub Actions CI/CD

  • 푸시 및 풀 리퀘스트 시 자동 실행

Related MCP server: mcp-playwright-test

🧰 기술 스택

  • JavaScript

  • Node.js

  • Playwright

  • Model Context Protocol (MCP)

  • MCP Inspector

  • Git

  • GitHub

  • GitHub Actions

🏗️ 아키텍처

                MCP Client / Inspector
                         |
                         v
                    MCP Server
                  (mcp/server.js)
                         |
                         v
                   run_tests Tool
                         |
             +-----------+-----------+
             |                       |
             v                       v
       Test Tool Layer          Suite Selection
       (tools/*.js)        login / inventory /
                           checkout / api /
                           regression
             |
             v
        testRunner.js
             |
             v
          Playwright
         /          \
        v            v
    UI Tests      API Tests
       |
       v
  Page Objects

📁 프로젝트 구조

my-ai-qa-agent/
│
├── .github/
│   └── workflows/
│       └── playwright.yml
│
├── data/
│   ├── customer.js
│   └── users.js
│
├── mcp/
│   └── server.js
│
├── pages/
│   ├── LoginPage.js
│   ├── InventoryPage.js
│   ├── CartPage.js
│   └── CheckoutPage.js
│
├── tests/
│   ├── api/
│   │   └── users.api.spec.js
│   ├── login.spec.js
│   ├── inventory.spec.js
│   └── checkout.spec.js
│
├── tools/
│   ├── testRunner.js
│   ├── runLoginTests.js
│   ├── runInventoryTests.js
│   ├── runCheckoutTests.js
│   ├── runApiTests.js
│   └── runRegressionTests.js
│
├── .env.example
├── .gitignore
├── package.json
├── playwright.config.js
└── README.md

pages/

UI 로케이터와 사용자 동작을 캡슐화하는 재사용 가능한 Page Object Model 클래스를 포함합니다.

tests/

Playwright UI 및 API 테스트 스펙을 포함합니다.

tools/

MCP 요청과 Playwright 테스트 실행 사이의 브리지 역할을 합니다. 개별 도구가 테스트 스위트를 선택하고 testRunner.js가 Playwright를 실행하여 결과를 요약합니다.

mcp/

QA 자동화 기능을 MCP 도구로 노출하는 MCP 서버를 포함합니다.

.github/workflows/

CI에서 자동화된 테스트 스위트를 실행하는 데 사용되는 GitHub Actions 워크플로를 포함합니다.

⚙️ 설치

저장소를 클론합니다:

git clone https://github.com/bisminizzar84/ai-qa-agent-mcp
cd ai-qa-agent-mcp

의존성을 설치합니다:

npm install

Playwright 브라우저를 설치합니다:

npx playwright install

.env.example을 기반으로 로컬 .env 파일을 생성합니다:

BASE_URL=https://www.saucedemo.com

🧪 테스트 실행

전체 테스트 스위트를 실행합니다:

npm test

브라우저를 표시하며 테스트를 실행합니다:

npx playwright test --headed

로그인 테스트만 실행합니다:

npx playwright test tests/login.spec.js

API 테스트를 실행합니다:

npx playwright test tests/api/users.api.spec.js

Playwright HTML 리포트를 엽니다:

npx playwright show-report

🤖 MCP 통합

이 프로젝트는 MCP 서버를 통해 QA 자동화를 노출합니다.

MCP Inspector를 통해 서버를 시작합니다:

npx -y @modelcontextprotocol/inspector@latest node mcp/server.js

run_tests MCP 도구는 여러 스위트를 지원합니다:

  • login

  • inventory

  • checkout

  • api

  • regression

요청 예시:

{
  "suite": "api"
}

응답 예시:

{
  "suite": "api",
  "status": "passed",
  "total": 1,
  "passed": 1,
  "failed": 0,
  "skipped": 0,
  "durationMs": 1841
}

MCP 계층은 테스트 실행을 MCP 호환 클라이언트가 사용할 수 있는 구조화된 결과로 변환합니다.

🔄 CI/CD

GitHub Actions는 코드가 main에 푸시되거나 풀 리퀘스트가 main을 대상으로 할 때 Playwright 테스트 스위트를 자동으로 실행합니다.

파이프라인은 다음을 수행합니다:

  1. 저장소 체크아웃

  2. Node.js 설정

  3. 의존성 설치

  4. Playwright 브라우저 설치

  5. 자동화된 테스트 실행

  6. Playwright 리포트 업로드

이를 통해 모든 코드 변경에 대한 자동화된 회귀 피드백을 제공합니다.

🔮 향후 개선 사항

  • 자연어 테스트 실행을 위해 LLM을 MCP 서버에 연결

  • AI 기반 실패 분석

  • 자동 결함 요약

  • 자연어 요구사항 기반 테스트 생성

  • 추가 API 커버리지

  • 병렬 및 크로스 브라우저 실행

  • Docker 기반 테스트 실행

  • 테스트 결과 알림

This server cannot be deployed

Let your AI agent see the webWeb-to-screenshot MCP for Claude, Cursor and Codex. No cookie banners. Free to start.snap-render.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

  • PlayrunnerOAuth
    dev.playrunner

    Discover Playwright workflows, start runs, and inspect results in Playrunner Cloud.

    Browser AutomationTesting & QA Tools
    13
  • MCP Server By TestMu AICOAuth
    com.lambdatest.mcp

    Run, debug, and triage tests from your IDE using natural language, no dashboard switching, no manual data transfers. The TestMu AI (formerly LambdaTest) MCP Server is a single remote server exposing four tool suites: HyperExecute — analyze your project, generate YAML configs and test runner commands, then monitor jobs and sessions. Automation — pull a TestID's details plus command, network, and console logs into one chat for instant root-cause analysis. Includes mobile app upload. SmartUI — explain pixel, layout, DOM, and perceptual changes in a visual regression run, with context-aware React/HTML/CSS fixes. Accessibility — audit any public URL or a local React app against WCAG and get ready-to-apply remediation steps. Connects over https://mcp.lambdatest.com/mcp using OAuth 2.1 — no API keys in your config. One-click install in Cursor; works with Claude, GitHub Copilot, Cline, and any MCP client. Tests execute on the TestMu AI cloud: 3,000+ browsers and 10,000+ real devices.

    Cloud PlatformsTesting & QA Tools
    881
  • Katalon True Platform MCPOAuth
    io.github.katalon-studio

    Katalon True Platform MCP: design tests, run with AI, upload reports, assess release readiness.

    Testing & QA ToolsMonitoringCI/CD & DevOps
    22
  • meok-mcp-test-mcp
    io.github.CSOAI-ORG

    MEOK MCP Test MCP — golden-file + schema-drift + tool-failure tests for any MCP server. Drop-in

    Testing & QA ToolsDeveloper Tools
    2

Related MCP Servers

Appeared in Searches