Qase MCP Server

# Qase MCP Server Qaseのテスト管理プラットフォームと連携するためのModel Context Protocol (MCP) サーバーです。 テストケースの作成、取得、テスト実行の管理などの機能を提供します。 ## セットアップ ### 前提条件 - Node.js v23.5.0 - Qase APIトークン - TypeScript ### インストール ```bash # パッケージのインストール npm install # ビルド npm run build ``` ### 環境設定 MCPの設定ファイル（`cline_mcp_settings.json`）に以下の設定を追加します： ```json { "mcpServers": { "qase": { "command": "node", "args": ["path/to/qase-mcp-server/build/index.js"], "env": { "QASE_API_TOKEN": "your-api-token" }, "disabled": false, "autoApprove": [] } } } ``` ## 利用可能なツール ### get_projects プロジェクト一覧を取得します。 **入力パラメータ**: なし **使用例**: ```json { "name": "get_projects" } ``` ### get_test_cases 指定したプロジェクトのテストケース一覧を取得します。 **入力パラメータ**: - `project_code`: プロジェクトコード（必須） - `suite_id`: スイートID（オプション）- 指定したスイートに属するテストケースのみを取得 **使用例**: ```json { "name": "get_test_cases", "arguments": { "project_code": "DEMO", "suite_id": 123 } } ``` ### create_test_case テストケースを作成します。 **入力パラメータ**: - `project_code`: プロジェクトコード（必須） - `title`: テストケースのタイトル（必須） - `description`: テストケースの説明（オプション） **使用例**: ```json { "name": "create_test_case", "arguments": { "project_code": "DEMO", "title": "ログイン機能のテスト", "description": "ユーザーログイン機能の動作確認" } } ``` ### create_suite テストスイートを作成します。 **入力パラメータ**: - `project_code`: プロジェクトコード（必須） - `title`: テストスイートのタイトル（必須） - `description`: テストスイートの説明（オプション） - `preconditions`: テストスイートの前提条件（オプション） - `parent_id`: 親スイートのID（オプション） **使用例**: ```json { "name": "create_suite", "arguments": { "project_code": "DEMO", "title": "認証機能テストスイート", "description": "認証に関連する全てのテストケース", "preconditions": "テスト用のデータベースが初期化されていること" } } ``` ### create_test_run テスト実行を作成します。 **入力パラメータ**: - `project_code`: プロジェクトコード（必須） - `title`: テスト実行のタイトル（必須） - `description`: テスト実行の説明（オプション） - `cases`: テスト実行に含めるテストケースのID一覧（オプション） **使用例**: ```json { "name": "create_test_run", "arguments": { "project_code": "DEMO", "title": "リグレッションテスト実行", "description": "v1.2.0リリース前の確認テスト", "cases": [1, 2, 3] } } ``` ### create_test_cases_in_bulk 複数のテストケースを一括で作成します。 **入力パラメータ**: - `project_code`: プロジェクトコード（必須） - `cases`: 作成するテストケースの配列（必須） - `title`: テストケースのタイトル（必須） - `description`: テストケースの説明（オプション） - `suite_id`: 所属するスイートのID（オプション） **使用例**: ```json { "name": "create_test_cases_in_bulk", "arguments": { "project_code": "DEMO", "cases": [ { "title": "ログイン成功パターン", "description": "正しい認証情報での確認", "suite_id": 123 }, { "title": "ログイン失敗パターン", "description": "不正な認証情報での確認", "suite_id": 123 } ] } } ``` ## エラーハンドリング 各ツールは以下のようなエラーを返す可能性があります： - 認証エラー: APIトークンが無効または未設定 - パラメータエラー: 必須パラメータの不足や不正な値 - APIエラー: Qase APIからのエラーレスポンス エラーメッセージには具体的な問題と対処方法が含まれます。 ## 開発 ```bash # 開発モードで実行（ファイル変更の監視） npm run dev # テストの実行 npm test ``` ## ライセンス ISC