MCP Zebrunner

🚀 Zebrunner MCP Server

Model Context Protocol (MCP)サーバー は、Zebrunner Test Case Management と統合され、ClaudeなどのAIアシスタントを通じて、QAチームがテストケース、テストスイート、およびテスト実行データを管理するのを支援します。

📖 インストールについてヘルプが必要ですか？ 詳細なセットアップ手順については、 を参照してください。

🚀 npmを使用してインストールしますか？ Claude Desktop、Cursor、IntelliJ IDEA、およびChatGPT Desktopの設定については、 を参照してください。

🚀 クイックスタート

このツールの概要

このツールを使用すると、以下のことができます。

• Zebrunnerからテストケースとテストスイートを取得する
• テストカバレッジを分析し、テストコードを生成する
• テスト実行結果と起動詳細を取得する
• インテリジェントルールを使用した自動チェックでテストケースの品質を検証する
• テストデータからレポートと洞察を生成する
• AIによる提案と自動修正でテストケースを改善する

これらすべてを、AIアシスタントでの自然言語コマンドで行うことができます！

前提条件

必要な知識

• 基本的なコマンドラインの使用方法（ターミナルを開き、コマンドを実行する）
• Zebrunnerの資格情報（ログインとAPIトークン）
• テスト管理の基本的な理解（テストケース、テストスイート）

ソフトウェア要件

• Node.js 18以上 - ここからダウンロード
• npm（Node.jsに付属）
• API資格情報を持つZebrunnerインスタンスへのアクセス

Node.jsの確認方法

ターミナル/コマンドプロンプトを開き、以下のコマンドを実行します。

node --version
npm --version

バージョン番号が表示されれば、準備完了です！

クイックスタート手順

1. コードの取得
   • オプションA：リポジトリからクローン（推奨）

git clone https://github.com/maksimsarychau/mcp-zebrunner.git
cd mcp-zebrunner

- **オプションB：ダウンロードして解凍**

プロジェクトファイルをダウンロードし、フォルダに解凍します。

2. 依存関係のインストール

npm install

3. Zebrunner接続の構成 プロジェクトフォルダに .env ファイルを作成し、Zebrunnerの詳細を記入します。

# Your Zebrunner instance URL (without trailing slash)
ZEBRUNNER_URL=https://your-company.zebrunner.com/api/public/v1

# Your Zebrunner login (usually your email)
ZEBRUNNER_LOGIN=your.email@company.com

# Your Zebrunner API token (get this from your Zebrunner profile)
ZEBRUNNER_TOKEN=your_api_token_here

# Optional: Enable debug logging (default: false)
DEBUG=false

# Optional: Enable intelligent rules system (auto-detected if rules file exists)
ENABLE_RULES_ENGINE=true

Zebrunner APIトークンの取得方法

1. Zebrunnerインスタンスにログインします。

2. プロファイル設定に移動します。

3. 「APIアクセス」セクションを見つけます。

4. 新しいAPIトークンを生成します。

5. トークンを .env ファイルにコピーします。

6. プロジェクトのビルド

npm run build

5. 接続のテスト

npm run test:health

「✅ Health check completed」と表示されれば、準備完了です！

新しいバージョンへの更新

現在のバージョンの確認

# Check your current version
npm run version
# or manually check package.json
cat package.json | grep '"version"'

更新手順

# 1. Pull latest changes from master branch
git pull origin master

# 2. Install any new dependencies
npm install

# 3. Rebuild the project
npm run build

# 4. Test your connection (requires valid .env file)
npm run test:health

重要な注意事項

• ✅ .env ファイルが正しく構成されている必要があります。ヘルスチェックが機能するためには、これが必要です。
• ✅ 更新後にClaude Desktop/Codeを再起動して、MCPサーバーを再読み込みしてください。
• ✅ 更新する前に、リリースノートを確認して、破壊的な変更がないかを確認してください。

ヘルスチェックが失敗した場合は、.env の構成とZebrunnerの資格情報を確認してください。

✨ 主な機能

インテリジェントルールシステム

このツールの特別な点

当社のMCPサーバーには、高度な3層ルールシステムが組み込まれており、テストケースの作業方法を革新します。

🎯 テストケースレビュールール (test_case_review_rules.md)

• 目的：核心的な品質基準と記述ガイドライン
• 機能：高品質なテストケースを記述するための基本原則を定義する
• 重要な領域：独立性、単一責任、包括的な前提条件、完全な手順カバレッジ
• 使用ツール：validate_test_case および improve_test_case ツール

✅ テストケース分析チェックポイント (test_case_analysis_checkpoints.md)

• 目的：100以上のチェックポイントを含む詳細な検証チェックリスト
• 機能：徹底的なテストケース分析のための細かい検証基準を提供する
• 重要な領域：構造検証、自動化の準備状況、プラットフォームの考慮事項、品質保証
• 使用ツール：validate_test_case での包括的なスコアリングと問題検出

⚙️ MCP Zebrunnerルール (mcp-zebrunner-rules.md)

• 目的：テスト生成とカバレッジ分析のための技術的な構成
• 機能：フレームワーク検出パターン、コードテンプレート、およびカバレッジしきい値を定義する
• 重要な領域：フレームワーク検出、テスト生成テンプレート、カバレッジしきい値、品質基準
• 使用ツール：generate_draft_test_by_key および get_enhanced_test_coverage_with_rules ツール

ルールの連携方法

graph TD
    A[Test Case] --> B[validate_test_case]
    B --> C[test_case_review_rules.md]
    B --> D[test_case_analysis_checkpoints.md]
    B --> E[Validation Result + Issues]
    
    E --> F[improve_test_case]
    F --> G[AI-Powered Improvements]
    
    A --> H[generate_draft_test_by_key]
    H --> I[mcp-zebrunner-rules.md]
    H --> J[Generated Test Code]
    
    A --> K[get_enhanced_test_coverage_with_rules]
    K --> I
    K --> L[Coverage Analysis + Rules Validation]

ルールシステムの重要性

1. 一貫性：すべてのチームメンバーが同じ品質基準に従います。
2. 自動化：自動検証により、手動レビューの時間を削減します。
3. 学習：新しいチームメンバーは、AIのフィードバックを通じてベストプラクティスを学びます。
4. カスタマイズ：ルールをプロジェクトの特定のニーズに合わせて調整できます。
5. 継続的な改善：AIが実績のあるパターンに基づいて改善提案を行います。

プロジェクトへのルールのカスタマイズ

3つのルールファイルをカスタマイズすることができます。

# Copy default rules to customize
cp test_case_review_rules.md my-project-review-rules.md
cp test_case_analysis_checkpoints.md my-project-checkpoints.md
cp mcp-zebrunner-rules.md my-project-technical-rules.md

# Use custom rules in validation
"Validate test case PROJ-123 using custom rules from my-project-review-rules.md"

カスタマイズの例

• モバイルプロジェクト：モバイル固有の検証ルールを追加する
• APIプロジェクト：APIテストパターンとデータ検証に焦点を当てる
• 異なるフレームワーク：コード生成テンプレートをカスタマイズする
• 会社の標準：組織のテストガイドラインに合わせる

利用可能なツール

接続後、AIアシスタントで自然言語を使用して、これらのツールを利用できます。以下は、カテゴリ別に整理された33以上の利用可能なツールの包括的なリファレンスです。

📋 テストケース管理

コアテストケースツール

ツール	説明	例の使用方法	最適な対象
get_test_case_by_key	詳細なテストケース情報を取得する	"Get test case MCP-123 details"	すべての役割
get_test_cases_advanced	自動化状態、日付での高度なフィルタリング	"Get test cases created after 2025-01-01 with automation state 'Manual'"	QA、SDET
get_test_cases_by_automation_state	特定の自動化状態でフィルタリングする	"Show me all 'Not Automated' test cases in project MCP"	SDET、マネージャー
get_test_case_by_title	タイトルでテストケースを検索する（部分一致）	"Find test cases with title containing 'login functionality'"	すべての役割
get_test_case_by_filter	スイート、日付、優先度、自動化状態での高度なフィルタリング	"Get test cases from suite 491 created after 2025-01-01 with high priority"	QA、マネージャー
get_automation_states	利用可能な自動化状態をリストする	"What automation states are available for project MCP?"	すべての役割
get_automation_priorities	ID付きの利用可能な優先度をリストする	"Show me all priority levels for project MCP"	すべての役割

バッチテストケース操作

ツール	説明	例の使用方法	最適な対象
get_all_tcm_test_cases_by_project	すべてのテストケースを取得する（ページネーションを処理する）	"Get all test cases for project MCP"	マネージャー、リード
get_all_tcm_test_cases_with_root_suite_id	階層情報付きのすべてのテストケースを取得する	"Get all test cases with their root suite information"	アナリスト

🌳 テストスイート階層と組織

スイート管理

ツール	説明	例の使用方法	最適な対象
list_test_suites	ページネーション付きでスイートをリストする	"List test suites for project MCP"	すべての役割
get_suite_hierarchy	階層ツリービューを表示する	"Show me the hierarchy of test suites with depth 3"	マネージャー、QA
get_root_suites	トップレベルのスイートを取得する	"Show me all root suites for project MCP"	マネージャー
get_all_subsuites	すべての子スイートを取得する	"Get all subsuites from root suite 18697"	QA、アナリスト

スイート分析ツール

ツール	説明	例の使用方法	最適な対象
get_tcm_suite_by_id	IDで特定のスイートを検索する	"Get details for suite 17470"	すべての役割
get_tcm_test_suites_by_project	包括的なスイートリストを取得する	"Get all suites for project MCP with hierarchy"	マネージャー
get_root_id_by_suite_id	任意のスイートのルートスイートを検索する	"What's the root suite for suite 12345?"	アナリスト

🔍 テストカバレッジと分析

カバレッジ分析

ツール	説明	例の使用方法	最適な対象
get_test_coverage_by_test_case_steps_by_key	実装カバレッジを分析する	"Analyze coverage for MCP-123 against this code: [paste code]"	開発者、SDET
get_enhanced_test_coverage_with_rules	ルールベースのカバレッジ分析を行う	"Enhanced coverage analysis for MCP-123 with framework detection"	SDET、リード

重複分析

ツール	説明	例の使用方法	最適な対象
analyze_test_cases_duplicates	手順の類似性で類似するテストケースを検索してグループ化する	"Analyze suite 12345 for duplicates with 80% similarity threshold"	QAマネージャー、SDET
analyze_test_cases_duplicates_semantic	LLMパワードの手順クラスタリングによる高度なセマンティック分析を行う	"Semantic analysis of suite 12345 with step clustering and medoid selection"	シニアQA、テストアーキテクト

🔗 クリック可能なリンク機能：両方の重複分析ツールは、ZebrunnerウェブUIへのクリック可能なリンクをサポートします。

• include_clickable_links: true を追加すると、Markdown出力でテストケースキーがクリック可能になります。
• JSON/DTO形式では、有効にすると自動的に webUrl フィールドが含まれます。
• リンクは、ZEBRUNNER_URL 環境変数から生成されます。
• 例："Analyze suite 17585 for duplicates with clickable links enabled"

🧪 テストコード生成と検証

AIパワードのツール

ツール	説明	例の使用方法	最適な対象
generate_draft_test_by_key	フレームワーク検出でテストコードを生成する	"Generate Java/Carina test for MCP-123 based on this implementation"	SDET、開発者
validate_test_case	品質検証と改善を行う	"Validate test case MCP-123 and suggest improvements"	QA、マネージャー
improve_test_case	専用の改善ツール	"Improve test case MCP-123 with specific suggestions"	QA、SDET

🚀 起動と実行管理

起動操作 ⭐ マネージャーに必須

ツール	説明	例の使用方法	最適な対象
get_launch_details	包括的な起動情報を取得する	"Get launch details for launch 118685"	マネージャー、リード
get_launch_summary	迅速な起動概要を表示する	"Show me summary for launch 118685"	マネージャー
get_all_launches_for_project	ページネーション付きですべての起動を取得する	"Get all launches for project MCP from last month"	マネージャー、リード
get_all_launches_with_filter	マイルストーン/ビルドでフィルタリングする	"Get launches for milestone 2.1.0 and build 'mcp-app-2.1.0'"	マネージャー、リード

📊 レポートと分析

テスト失敗分析 🆕 画期的

ツール	説明	例の使用方法	最適な対象
analyze_test_failure	ログ、スクリーンショット、エラー分類、および推奨事項を使用した失敗したテストの深いフォレンジック分析を行う。v5.11.0で新機能：最後に合格した実行と比較する！何が変更されたかを表示する（ログ、期間、環境）。また：format: 'jira' で、自動優先度、ラベル、およびクリック可能な 🎥 ビデオリンク付きのJiraチケットを生成する！	"Analyze test failure 5451420 in launch 120806 and compare with last passed execution"	QAエンジニア、SDET、マネージャー
get_test_execution_history	🆕 v5.11.0で新機能！ 起動間でのテスト実行傾向を追跡する。合格/不合格の履歴を表示し、最後に合格した実行を見つけ、合格率を計算する。重要な検出：最近のすべての実行でテストが失敗した場合を強調表示する！	"Show execution history for test 5478492" または "Has test 5478492 been failing consistently?"	QAエンジニア、SDET、マネージャー
detailed_analyze_launch_failures	🚀 v4.12.1で強化 関連する問題がない失敗を、Claudeレベルのインテリジェンス + Jira形式のサポート で分析する。エグゼクティブサマリー、タイムライン、パターン、優先度で自動的に深掘りする。新機能：起動全体のJira対応チケットを生成する！	"Analyze failures in launch 120806" または format: 'jira' で	QAマネージャー、SDET、チームリード

✅ v5.2.4で修正！ 信頼性とビデオリンクの改善

• 🎥 ビデオURLの修正：現在、信頼性の高いビデオアーティファクト抽出のために、テストセッションAPI (/api/reporting/v1/launches/{id}/test-sessions) を使用しています。
• 🛡️ 包括的なエラーハンドリング：欠落しているスクリーンショット/ログを適切に処理します（エラーをスローする代わりに空の配列を返します）。
• 🚫 "no result received" エラーの解消：すべてのAPI呼び出しには、フォールバック付きの適切なtry-catchブロックがあります。
• 🐛 デバッグの改善：設定で debug: true が有効になっている場合、ロギングが強化されます。
• 📊 スキーマの更新：下位互換性のために、古いAPI構造と新しいAPI構造の両方をサポートしています。

🎫 v4.12.1で新機能！ Jira対応チケット形式

• format: 'jira' を使用して、貼り付け可能なJiraチケットを生成します。
• 自動計算される優先度：安定性と影響に基づいています。
• スマートラベル：test-automation、locator-issue、flaky-test など。
• 完全なJiraマークアップ：テーブル、パネル、コードブロック、クリック可能なリンク。
• 🎥 目立つビデオリンク：美しいパネル + リンクセクション。
• 貼り付け可能：手動でのフォーマットは不要です。
• チケットごとに5 - 10分の節約：一貫した品質です。

🧠 v4.11.1で強化！ detailed_analyze_launch_failures は、Claudeが手動で行うような自動的な深い合成を提供します。

• 🎯 エグゼクティブサマリー：主要な調査結果、パターン、および安定性指標。
• 📅 タイムライン分析：失敗が最初に現れた時期、進行状況の追跡。
• 🔬 パターン分析：根本原因別にグループ化し、影響を受けるテストと安定性%を表示する。
• 🎯 優先度ベースの推奨事項：🔴 高 / 🟡 中 / 🟢 低 と影響分析。
• 📋 強化されたテスト詳細：完全なエラーメッセージ、スタックトレース、タイムスタンプ。
• ❓ スマートなフォローアップ質問：次の調査手順を案内する。
• スマートフィルタリング：デフォルトでは、関連する問題がないテストのみを分析する。
• すべてのテストに対するオプションのAIスクリーンショット分析。
• 手動でのフォローアップ不要 - 1回の呼び出しで完全な情報を取得できます！

🆕 v5.11.0で新機能！ テスト実行履歴と比較

• 📊 実行傾向の追跡：get_test_execution_history で起動間の合格/不合格の履歴を表示する。
• 🔄 最後に合格した実行と比較：analyze_test_failure の新しい compareWithLastPassed パラメータ。
  • ログを比較する（新しいエラーの検出）。
  • 期間を比較する（パフォーマンスの回帰）。
  • 環境を比較する（デバイス/プラットフォームの変更）。
  • スクリーンショットを比較する（視覚的な違い）。
• ⚠️ 重要な検出：最近のすべての実行でテストが失敗した場合を自動的に強調表示する。
• 🎯 回帰分析：合格と不合格の実行間で何が変更されたかを正確に確認する。
• 📈 合格率メトリクス：時間の経過に伴うテストの安定性を計算する。
• 例のプロンプトについては、TOOLS_CATALOG.md を参照してください！

スクリーンショット分析とビジュアルフォレンジックス 🎯 v4.11.0で強化

ツール	説明	例の使用方法	最適な対象
download_test_screenshot	認証付きでZebrunnerから保護されたスクリーンショットをダウンロードする	"Download screenshot from https://your-workspace.zebrunner.com/files/abc123 for test 5451420"	QAエンジニア、自動化エンジニア
analyze_screenshot	OCR、UI検出、およびClaude Visionを使用したビジュアル分析を行う	"Analyze screenshot https://your-workspace.zebrunner.com/files/abc123 with OCR and detailed analysis"	QAエンジニア、SDET、開発者

📸 強化！ スクリーンショット分析は、analyze_test_failure および analyze_launch_failures に直接統合されました - 個別に呼び出す必要はありません！詳細については、スクリーンショット分析ガイド を参照してください。

プラットフォームと結果分析 ⭐ 管理に重要

ツール	説明	例の使用方法	最適な対象
get_platform_results_by_period	プラットフォーム/期間別のテスト結果を取得する	"Get iOS test results for the last 7 days"	マネージャー、リード
get_top_bugs	最も頻繁に発生する欠陥を表示する	"Show me top 10 bugs from last week"	マネージャー、開発者
get_bug_review	詳細なバグレビューを行い、失敗分析、優先度の内訳、および自動的な詳細取得を行う	"Get bug review with full failure details for top 10 bugs"	マネージャー、QA、開発者
get_bug_failure_info	ハッシュコードでの包括的な失敗情報を取得する（自動取得の代替手段）	"Get failure info for hashcode 1051677506"	開発者、SDET
get_project_milestones	利用可能なマイルストーンを取得する	"Get all milestones for project MCP"	マネージャー、PM

プロジェクト探索

ツール	説明	例の使用方法	最適な対象
get_available_projects	アクセス可能なすべてのプロジェクトを探索する	"What projects can I access?"	すべての役割
test_reporting_connection	API接続をテストする	"Test my connection to Zebrunner"	すべての役割

🏃 テスト実行管理

パブリックAPIテスト実行 ⭐ 分析に強力

ツール	説明	例の使用方法	最適な対象
list_test_runs	高度なテスト実行フィルタリングを行う	"Get test runs from last 30 days with status 'FAILED'"	マネージャー、SDET
get_test_run_by_id	詳細なテスト実行情報を取得する	"Get details for test run 12345"	マネージャー、QA
list_test_run_test_cases	特定の実行内のテストケースを表示する	"Show me all test cases in test run 12345"	QA、アナリスト

構成管理

ツール	説明	例の使用方法	最適な対象
get_test_run_result_statuses	利用可能な結果ステータスを取得する	"What result statuses are configured for project MCP?"	QA、SDET
get_test_run_configuration_groups	構成オプションを表示する	"Show me configuration groups for project MCP"	SDET、リード

マネージメントに特化したクイックコマンド

📈 日次スタンドアップレポート

# Get yesterday's results
"Get platform results for last 7 days for project MCP"

# Check recent failures  
"Show me top 5 bugs from last week"

# Review recent launches
"Get all launches for project MCP from last 3 days"

🔍 テストスイートの最適化

# Basic duplicate analysis
"Analyze suite 12345 for duplicates with 80% similarity threshold"

# Advanced semantic analysis with step clustering
"Semantic analysis of suite 12345 with 85% step clustering and medoid selection"

# Analyze specific test cases for duplicates
"Analyze test cases MCP-123, MCP-124, MCP-125 for duplicates"

# Project-wide duplicate analysis (use with caution - large datasets)
"Analyze project MCP for test case duplicates with 85% similarity"

# Get detailed similarity matrix with pattern types
"Analyze suite 12345 for duplicates with similarity matrix included"

# Two-phase clustering with semantic insights
"Semantic duplicate analysis with step clustering threshold 90% and insights enabled"

# Enable clickable links for easy navigation
"Analyze suite 17585 for duplicates with clickable links enabled"

📊 週次マネージメントレポート

# Comprehensive project health
"Get all launches for project MCP with milestone filter"

# Platform performance analysis
"Get iOS and Android test results for the last month"

# Quality metrics
"Get all test cases by automation state for project MCP"

🎯 マイルストーンとリリース計画

# Milestone tracking
"Get project milestones for MCP with completion status"

# Build-specific results
"Get launches for build 'mcp-app-2.1.0-release' and milestone '2.1.0'"

# Release readiness
"Get automation readiness for all test cases in project MCP"

🐞 問題分析とトラブルシューティング

# Bug analysis
"Show me top 10 most frequent bugs with issue links"

# Failure investigation
"Get test run 12345 details with all test cases"

# Platform-specific issues
"Get Android test results for last 7 days with failure analysis"

役割別のプロンプトとワークフロー

👩‍💻 マニュアルQAエンジニア

日次テストケースレビュー

"Get test case MCP-45 details and validate its quality"
"Show me all test cases in suite 18708 that need improvement"
"Validate test case MCP-67 and suggest specific improvements"
"Find test cases with title containing 'login' to review authentication tests"
"Get test cases from suite 491 with high priority for today's testing"

テストケースの作成と改善

"I'm writing a test case for login functionality. What should I include based on our quality standards?"
"Improve test case MCP-89 - it's missing some preconditions"
"Check if test case MCP-12 is ready for manual execution"

テストスイートの組織化

"Show me the hierarchy of test suites for project MYAPP to understand the structure"
"Get all subsuites from Authentication suite to review test coverage"
"List test cases in suite 18708 and identify which ones need validation"
"Find test cases with title containing 'payment' to organize payment testing"
"Get all high priority test cases from suite 491 for release testing"

カバレッジ分析

"I executed test case MCP-34 manually. Here's what I did: [paste your execution notes]. Analyze coverage against the documented steps."
"Compare test case MCP-56 with this manual testing session: [paste session details]"

🤖 テスト自動化エンジニアとSDET

自動化の準備状況評価

"Validate test case MCP-78 for automation readiness"
"Get all test cases in suite 18708 and identify which ones are ready for automation"
"Check test case MCP-23 - does it have clear, unambiguous steps for automation?"
"Find test cases with title containing 'API' to prioritize API automation"
"Get automation priorities to understand which test cases to automate first"
"Get test cases from suite 491 with 'Not Automated' state for automation planning"

テストコード生成

"Generate Java/Carina test code for MCP-45 based on this existing framework: [paste framework code]"
"Create JavaScript/Jest test for MCP-67 using this test structure: [paste test example]"
"Generate Python/Pytest code for MCP-89 with these page objects: [paste page object code]"

カバレッジ分析と検証

"Analyze test coverage for MCP-34 against this automated test: [paste test code]"
"Enhanced coverage analysis for MCP-56 with rules validation - here's my implementation: [paste code]"
"Compare test case MCP-78 steps with this Selenium test: [paste selenium code]"

フレームワーク統合

"Generate test code for MCP-45 using our Carina framework with these page objects: [paste existing code]"
"Create test automation for MCP-67 that integrates with this CI/CD pipeline: [paste pipeline config]"
"Generate API test for MCP-89 using this RestAssured setup: [paste API test framework]"

バッチ自動化分析

"Validate all test cases in Authentication suite for automation readiness"
"Generate coverage report for all test cases in project MYAPP"
"Identify test cases in suite 18708 that have automation blockers"
"Find test cases with title containing 'regression' for automation sprint planning"
"Get test cases from suite 491 created after 2025-01-01 with high priority for next automation cycle"
"Get automation priorities and states to create automation roadmap"

👨‍💻 開発者

テストケースの理解

"Get test case MCP-45 details to understand what I need to implement"
"Show me test cases related to login functionality in project MYAPP"
"Explain test case MCP-67 requirements in developer-friendly format"
"Find test cases with title containing 'authentication' for my feature development"
"Get high priority test cases from suite 491 that I need to implement"

実装の検証

"I implemented this feature: [paste code]. Analyze coverage against test case MCP-34"
"Here's my API implementation: [paste code]. Check coverage against test case MCP-56"
"Validate my UI implementation against test case MCP-78: [paste component code]"

テスト用のコード生成

"Generate unit tests for test case MCP-45 using Jest framework"
"Create integration tests for MCP-67 based on this API: [paste API code]"
"Generate test data setup for MCP-89 using this database schema: [paste schema]"

バグ分析

"Get test execution results for launch 118685 to understand recent failures"
"Show me top bugs from last week related to my feature area"
"Get detailed bug review for Android project from last 14 days"
"Show me comprehensive failure information for hashcode 1051677506"
"What are the top 50 bugs affecting our project this month?"
"Give me a summary of bug failures with reproduction dates from last 7 days"
"Analyze test case MCP-34 - why might it be failing in automation?"

👔 テストマネージャーとチームリード

チームの品質メトリクス

"Get quality metrics for all test cases in project MYAPP"
"Show me test cases that need improvement in suite 18708"
"Generate quality report for test cases created this month"
"Find test cases with title containing 'critical' to assess critical path quality"
"Get automation priorities to align team efforts with business priorities"
"Get test cases from suite 491 with high priority that need quality improvements"

テストスイートの分析

"Show me the complete test suite hierarchy for project MYAPP"
"Analyze test coverage across all suites in project MYAPP"
"Get automation readiness status for all test cases in Authentication suite"

チームのパフォーマンスと計画

"Get test execution results by platform for the last 30 days"
"Show me top 10 most frequent bugs to prioritize fixes"
"Analyze test case quality trends in project MYAPP"
"Get all launches for project MYAPP from last 30 days with milestone tracking"
"Show me platform results for last 7 days to track team performance"
"Get test runs with status 'FAILED' from last week for team retrospective"

プロセスの改善

"Validate all test cases in suite 18708 to identify common quality issues"
"Generate improvement recommendations for test cases created by junior team members"
"Analyze which test cases are consistently failing automation"
"Get top 10 bugs from last month to identify process improvements"
"Show me test runs with detailed failure analysis for process optimization"
"Get automation readiness metrics across all test cases"
"Find test cases with title containing 'flaky' to address test stability"
"Get test cases from suite 491 with medium priority that could be automated"
"Get automation priorities to optimize team resource allocation"

レポートと利害関係者へのコミュニケーション

"Generate comprehensive test coverage report for project MYAPP in markdown format"
"Get test execution summary for launch 118685 for stakeholder presentation"
"Show me test quality metrics and improvement suggestions for quarterly review"
"Get platform results by period for executive dashboard"
"Create milestone progress report with test execution data"
"Generate weekly team performance report with launch and bug metrics"

日次管理タスク

"Get all launches for project MYAPP from yesterday"
"Show me top 5 bugs from last 7 days with issue links"
"Get platform results for iOS and Android from last week"
"Check automation readiness for upcoming release milestone"
"Get test run details for failed runs from last 24 hours"
"Show me project milestones and their completion status"

🏢 プロジェクトオーナーとプロダクトマネージャー

プロジェクトの健全性の概要

"Get overall test coverage status for project MYAPP"
"Show me test execution results by platform for the last quarter"
"Generate project testing health report in markdown format"
"Get all launches for project MYAPP with milestone and build tracking"
"Show me platform results summary for executive review"
"Get project milestones with completion status and testing metrics"

機能テストのステータス

"Get test cases related to [feature name] in project MYAPP"
"Show me test execution results for [feature name] functionality"
"Analyze test coverage for [epic/story] requirements"
"Get launches filtered by milestone for feature release tracking"
"Show me test runs for specific build versions"

品質保証メトリクス

"Get quality metrics for all test cases in project MYAPP"
"Show me test case validation results and improvement areas"
"Generate testing quality report for stakeholder presentation"
"Get top bugs analysis for quality trend assessment"
"Show me automation vs manual testing ratio across the project"
"Find test cases with title containing 'smoke' to assess smoke test coverage"
"Get automation priorities to communicate testing strategy to stakeholders"
"Get test cases from suite 491 with critical priority for risk assessment"

リスク評価

"Show me top 10 most frequent bugs in project MYAPP"
"Get test cases that are not ready for automation and assess risk"
"Analyze test execution trends to identify potential quality risks"
"Get platform-specific failure rates for the last month"
"Show me test runs with high failure rates for risk mitigation"
"Get milestone-based testing progress for release risk assessment"

計画とリソース配分

"Get automation readiness assessment for all test cases in project MYAPP"
"Show me test cases that need quality improvement and estimate effort"
"Analyze test suite structure to identify optimization opportunities"
"Get testing resource utilization by platform and time period"
"Show me milestone testing progress for sprint planning"
"Get comprehensive launch analysis for capacity planning"
"Find test cases with title containing 'performance' to plan performance testing"
"Get automation priorities to allocate automation resources effectively"
"Get test cases from suite 491 created in last month to plan review sessions"

エグゼクティブレポート

"Generate executive dashboard with platform results and bug trends"
"Get quarterly testing metrics with milestone progress"
"Show me ROI analysis of automation vs manual testing efforts"
"Create board-ready testing status report with key metrics"
"Get testing velocity trends for project timeline assessment"

📖 出力形式

すべてのツールは、複数の出力形式をサポートしています。

• json - 構造化データ（デフォルト）
• markdown - セクションとテーブル付きのリッチなフォーマット出力
• string - 人間が読みやすいテキスト要約
• dto - 生データオブジェクト

例：

"Get test case PROJ-123 in markdown format"
"Show me test suites as JSON"

⚙️ 設定オプション

環境変数

# Required
ZEBRUNNER_URL=https://your-instance.zebrunner.com/api/public/v1
ZEBRUNNER_LOGIN=your.email@company.com
ZEBRUNNER_TOKEN=your_api_token

# Optional - Basic Settings
DEBUG=false                        # Enable detailed logging (default: false)
DEFAULT_PAGE_SIZE=100             # Default items per page (optional)
MAX_PAGE_SIZE=100                 # Maximum items per page (optional)

# Optional - Intelligent Rules System
ENABLE_RULES_ENGINE=true          # Enable intelligent rules (auto-detected if rules file exists)
MCP_RULES_FILE=custom-rules.md    # Custom technical rules file (optional)
MIN_COVERAGE_THRESHOLD=70         # Minimum coverage percentage (optional)
REQUIRE_UI_VALIDATION=true        # Require UI validation in tests (optional)
REQUIRE_API_VALIDATION=true       # Require API validation in tests (optional)

ルールシステムの設定

ルールシステムは、プロジェクトルートのルールファイルを自動的に検出して使用します。

自動検出

プロジェクトルートに mcp-zebrunner-rules.md ファイルがある場合、ルールエンジンは自動的に有効になります。

カスタムルールファイル

3種類のルールをカスタマイズすることができます。

1. テストケースレビュールール (test_case_review_rules.md)

# Custom Test Case Review Rules

## Rule 1: Title Quality
- Titles must be descriptive and specific
- Minimum length: 10 characters
- Should not contain vague terms like "test", "check"

## Rule 2: Test Steps
- Each step must have clear action and expected result
- Steps should be numbered and sequential
- Avoid combining multiple actions in one step

2. 分析チェックポイント (test_case_analysis_checkpoints.md)

# Custom Analysis Checkpoints

## Independence Assessment
- [ ] Can this test case run independently?
- [ ] Are all preconditions explicitly stated?
- [ ] No dependencies on other test cases?

## Automation Readiness
- [ ] All steps are unambiguous?
- [ ] Technical feasibility confirmed?
- [ ] Stable selectors available?

3. 技術的なルール (mcp-zebrunner-rules.md)

# Technical Configuration

## Coverage Thresholds
- Overall Coverage: 80%
- Critical Steps: 95%
- UI Validation Steps: 85%

## Framework Detection
**Java/TestNG**:
- Keywords: @Test, TestNG, WebDriver
- File patterns: *Test.java, *Tests.java

🧪 セットアップのテスト

ヘルスチェックの実行

npm run test:health

API接続のテスト

npm run smoke

完全なテストスイートの実行

npm test

特定のテストタイプの実行

npm run test:unit           # Fast unit tests
npm run test:integration    # API integration tests
npm run test:e2e           # End-to-end tests

🔍 トラブルシューティング

一般的な問題

"Authentication failed" または 401エラー

• ✅ ZEBRUNNER_LOGIN と ZEBRUNNER_TOKEN を確認してください。
• ✅ APIトークンがまだ有効であることを確認してください。
• ✅ Zebrunnerでユーザーが適切な権限を持っていることを確認してください。

"Project not found" または 404エラー

• ✅ プロジェクトキーのスペルを確認してください（例："MYAPP"、"myapp" ではなく）。
• ✅ Zebrunnerでプロジェクトへのアクセス権があることを確認してください。
• ✅ 一部のエンドポイントは、すべてのZebrunnerインスタンスで利用できるとは限りません。

"Connection timeout" エラー

• ✅ ZEBRUNNER_URL が正しいことを確認してください。
• ✅ ネットワークがZebrunnerインスタンスに到達できることを確認してください。
• ✅ 設定でタイムアウトを増やしてみてください。

MCP統合が機能しない

• ✅ dist/server.js へのパスが正しいことを確認してください。
• ✅ プロジェクトが正常にビルドされたことを確認してください（npm run build）。
• ✅ MCP構成で環境変数が設定されていることを確認してください。
• ✅ Claude Desktop/Codeのログを見て、エラーメッセージを確認してください。

ルールエンジンが機能しない

• ✅ .env ファイルで ENABLE_RULES_ENGINE=true であることを確認してください。
• ✅ ルールファイルが存在し、意味のある内容が含まれていることを確認してください。
• ✅ ルールファイルを変更した後、MCPサーバーを再起動してください。
• ✅ デバッグログを確認して、ルールの解析エラーを確認してください。

デバッグモード

詳細なロギングを有効にして、問題をトラブルシューティングします。

DEBUG=true

これにより、以下が表示されます。

• APIリクエストとレスポンス
• エラー詳細とスタックトレース
• パフォーマンスメトリクス
• 機能の可用性
• ルールの解析と検証の詳細

ヘルプの取得

1. ログを確認する - デバッグモードを有効にして、エラーメッセージを探します。
2. 接続をテストする - npm run test:health を実行します。
3. 構成を確認する - .env ファイルを再確認します。
4. Zebrunnerの権限を確認する - ユーザーが適切なアクセス権を持っていることを確認します。
5. ルールファイルを検証する - ルールファイルに意味のある内容が含まれていることを確認します。

🎯 例のワークフロー

ワークフロー1: テストケースレビュー（マニュアルQA）

1. "Get test case PROJ-123 details"
2. "Validate test case PROJ-123"
3. "Improve test case PROJ-123 with specific suggestions"
4. "Check if test case PROJ-123 is ready for manual execution"

ワークフロー2: テスト自動化（SDET）

1. "Validate test case PROJ-456 for automation readiness"
2. "Generate Java/Carina test code for PROJ-456"
3. "Analyze coverage between test case and my implementation"
4. "Get automation readiness assessment"

ワークフロー3: 実装の検証（開発者）

1. "Get test case PROJ-789 details to understand requirements"
2. "Analyze coverage for PROJ-789 against my implementation"
3. "Generate unit tests based on test case requirements"
4. "Validate implementation completeness"

ワークフロー4: 品質管理（チームリード）

1. "Get quality metrics for all test cases in project MYAPP"
2. "Show me test cases that need improvement"
3. "Generate team quality report"
4. "Identify automation readiness across the project"

ワークフロー5: プロジェクトの健全性（プロダクトマネージャー）

1. "Get overall test coverage status for project MYAPP"
2. "Show me test execution results by platform"
3. "Generate project testing health report"
4. "Identify quality risks and improvement opportunities"

🔧 高度な機能

バッチ操作

一度に複数のテストケースを処理します。

"Validate all test cases in suite 18708"
"Generate coverage report for all test cases in project MYAPP"
"Improve all test cases that have quality issues"

カスタム出力形式

必要な形式でデータを取得します。

"Get test cases as JSON for API integration"
"Show test suite hierarchy in markdown for documentation"
"Generate quality report in markdown for stakeholder presentation"

フィルタリングと検索

必要なものを正確に見つけます。

"Get test cases created after 2025-01-01"
"Find test cases with automation state 'Manual'"
"Show me test cases that are not ready for automation"

ルールベースの分析

インテリジェントな検証を活用します。

"Validate test case PROJ-123 using custom rules from my-project-rules.md"
"Enhanced coverage analysis with framework-specific rules"
"Generate improvement suggestions based on team quality standards"

📚 追加ドキュメント

📖 ツールリファレンス

• TOOLS_CATALOG.md - 🆕 40以上のすべてのツールの完全なカタログと自然言語の例
• INSTALL-GUIDE.md - 📥 ステップバイステップのインストールとセットアップガイド

🧠 インテリジェントルールシステム

• docs/INTELLIGENT_RULES_SYSTEM.md - 🧠 3層のインテリジェントルールシステムの完全なガイド
• docs/RULES_QUICK_REFERENCE.md - ⚡ ルールシステムのコマンドと設定のクイックリファレンス

📋 ルールファイル（カスタマイズ可能）

• test_case_review_rules.md - 🎯 核心的な品質基準と記述ガイドライン
• test_case_analysis_checkpoints.md - ✅ 100以上の詳細な検証チェックポイント
• mcp-zebrunner-rules.md - ⚙️ テスト生成とカバレッジ分析のための技術的な構成

🔍 専用ガイド

• docs/SCREENSHOT_ANALYSIS.md - 📸 スクリーンショットのダウンロードとビジュアル分析ガイド
• change-logs.md - 📝 バージョン履歴と機能更新

🛠️ 機能ドキュメント

• docs/NEW_LAUNCHER_TOOL.md - 起動とレポートツールの詳細情報
• docs/SUITE_HIERARCHY.md - スイート階層機能の完全なガイド
• docs/TEST_CASE_VALIDATION_IMPLEMENTATION.md - テストケース検証システムの詳細
• docs/ENHANCED_VALIDATION_FEATURES.md - 高度な検証と改善機能
• docs/SCREENSHOT_ANALYSIS.md - 📸 スクリーンショット分析とビジュアルフォレンジックスガイド 🆕

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 適切なテストを含めて変更を加えます。
4. すべてのテストが通過することを確認します：npm test
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトは、AGPL-3.0 ライセンスの下で公開されており、MCPサーバーへのすべての改善がオープンソースとして維持されることを保証します。特に、ソフトウェアが