Groundng (QA For Cursor)

🚀 AI駆動のネットワークテストツール

このプロジェクトはAI駆動のネットワークテストツールです。自然言語指令により、ネットワークテストタスクを自動的に実行および管理します。テスト手順の記録、実行、発見をサポートし、MCPプロトコルと統合されており、設定したAIコーディングアシスタントを通じて操作できます。

🚀 クイックスタート

このツールは、自然言語指令を用いてネットワークテストタスクを自動化します。テストの記録、実行、潜在的なテスト手順の発見が可能で、MCPプロトコルとの統合により、AIコーディングアシスタントとの連携も可能です。

✨ 主な機能

• テスト記録：自然言語の説明に基づいてブラウザ操作を自動実行し、JSON形式で保存します。
• テスト実行：記録されたテストケースを読み込み、結果を検証します。
• テスト発見：ウェブページの構造を分析し、潜在的なテスト手順の提案を生成します。
• MCPプロトコルサポート：設定により、AIコーディングアシスタントから直接呼び出すことができます。

📦 インストール

前提条件

• Python 3.10+
• LLM APIアクセス（Gemini 2.0 Flashの使用を推奨）
• インストール済みのMCP CLIツール (pip install mcp[cli])
• Playwrightブラウザサポート (playwright install)

インストール手順

1. リポジトリをクローンします：

git clone <repository-url>
cd <repository-name>

2. 仮想環境を作成します（推奨）：

python -m venv venv
source venv/bin/activate # Linux/macOS
# venv\Scripts\activate # Windows

3. 依存関係をインストールします：

pip install -r requirements.txt

4. Playwrightブラウザサポートをインストールします：

playwright install --with-deps # ブラウザとシステム依存関係をインストール

📚 ドキュメント

設定説明

1. プロジェクトのルートディレクトリにある.env.exampleファイルを.envにリネームします。
2. LLM APIキーとその他必要な情報を追加します：

# .env
LLM_API_KEY="YOUR_LLM_API_KEY"

• YOUR_LLM_API_KEYを実際のAPIキーに置き換えてください。

MCPサーバー設定

MCP設定に以下の内容を追加します：

{
  "mcpServers": {
    "Web-QA":{
      "command": "uv",
      "args": ["--directory","path/to/cloned_repo", "run", "mcp_server.py"]
    }
  }
}

AIコーディングアシスタントとのやり取りを可能にするため、このサーバーを実行したままにしてください。

一般的なコマンド例

• テストの記録：

"記録するテスト：https://practicetestautomation.com/practice-test-login/にアクセスし、ユーザー名フィールドに'student'を入力し、パスワードフィールドに'Password123'を入力し、送信ボタンをクリックし、'Congratulations student'というテキストが表示されることを検証する。"

• テストの実行：

"回帰テストoutput/test_practice_test_login_20231105_103000.jsonを実行する。"

• テスト手順の発見：

"https://practicetestautomation.com/practice/から潜在的なテスト手順を発見する。"

• 記録されたテストの一覧表示：

"利用可能なウェブテスト記録を一覧表示する。"

出力説明

• 記録されたテスト：output/ディレクトリにJSONファイルとして保存されます（形式についてはtest_schema.mdを参照）。
• 実行結果：実行状態（状態、エラー、証拠パス）をまとめたJSONオブジェクトが返されます。完全な実行結果はoutput/execution_result_....jsonに保存されます。
• 発見結果：発見されたURLと提案手順を含むJSONオブジェクトが返されます。完全な発見結果はoutput/discovery_results_....jsonに保存されます。

🔧 開発と貢献

貢献を歓迎します！CONTRIBUTING.mdを参照して、始め方、問題の報告方法、プルリクエストの提出方法を確認してください。

📄 ライセンス

このプロジェクトはAPACHE-2.0の下でライセンスされています。