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 Objectsmy-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.mdpages/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 installPlaywright ブラウザをインストールします：
npx playwright install.env.example に基づいてローカルの .env ファイルを作成します：
BASE_URL=https://www.saucedemo.com完全なテストスイートを実行します：
npm testブラウザを表示してテストを実行します：
npx playwright test --headedログインテストのみを実行します：
npx playwright test tests/login.spec.jsAPI テストを実行します：
npx playwright test tests/api/users.api.spec.jsPlaywright HTML レポートを開きます：
npx playwright show-reportこのプロジェクトは、MCP サーバーを通じて QA 自動化を公開します。
MCP Inspector を通じてサーバーを起動します：
npx -y @modelcontextprotocol/inspector@latest node mcp/server.jsrun_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 互換クライアントが利用できるようにします。
GitHub Actions は、コードが main にプッシュされたとき、またはプルリクエストが main を対象とするときに、Playwright テストスイートを自動的に実行します。
パイプラインは以下を実行します：
リポジトリのチェックアウト
Node.js のセットアップ
依存関係のインストール
Playwright ブラウザのインストール
自動テストの実行
Playwright レポートのアップロード
これにより、すべてのコード変更に対して自動化された回帰フィードバックが提供されます。
自然言語でのテスト実行のために LLM を MCP サーバーに接続
AI による失敗分析の支援
欠陥サマリーの自動生成
自然言語の要件からのテスト生成
API カバレッジの追加
並列およびクロスブラウザ実行
Docker 化されたテスト実行
テスト結果の通知
This server cannot be deployed
Discover Playwright workflows, start runs, and inspect results in Playrunner Cloud.
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.
Katalon True Platform MCP: design tests, run with AI, upload reports, assess release readiness.
MEOK MCP Test MCP — golden-file + schema-drift + tool-failure tests for any MCP server. Drop-in
