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