Skip to main content
Glama
deenesjakoruzh
bisminizzar84

AI QA Agent MCP

by bisminizzar84
OverviewSchemaRelated ServersScoreDiscussions
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

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

🧰 기술 스택

  • 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 installed

-
license - not tested
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • meok-mcp-test-mcp

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

  • browser-mcp

    Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.

  • SmartBear MCP

    MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bisminizzar84/ai-qa-agent-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server