Qase MCP Server
Qaseのテスト管理プラットフォームと連携するためのModel Context Protocol (MCP) サーバーです。 テストケースの作成、取得、テスト実行の管理などの機能を提供します。
セットアップ
前提条件
- Node.js v23.5.0
- Qase APIトークン
- TypeScript
インストール
# パッケージのインストール
npm install
# ビルド
npm run build
環境設定
MCPの設定ファイル（cline_mcp_settings.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
プロジェクト一覧を取得します。
入力パラメータ: なし
使用例:
{
"name": "get_projects"
}
get_test_cases
指定したプロジェクトのテストケース一覧を取得します。
入力パラメータ:
project_code: プロジェクトコード（必須）suite_id: スイートID（オプション）- 指定したスイートに属するテストケースのみを取得
使用例:
{
"name": "get_test_cases",
"arguments": {
"project_code": "DEMO",
"suite_id": 123
}
}
create_test_case
テストケースを作成します。
入力パラメータ:
project_code: プロジェクトコード（必須）title: テストケースのタイトル（必須）description: テストケースの説明（オプション）
使用例:
{
"name": "create_test_case",
"arguments": {
"project_code": "DEMO",
"title": "ログイン機能のテスト",
"description": "ユーザーログイン機能の動作確認"
}
}
create_suite
テストスイートを作成します。
入力パラメータ:
project_code: プロジェクトコード（必須）title: テストスイートのタイトル（必須）description: テストスイートの説明（オプション）preconditions: テストスイートの前提条件（オプション）parent_id: 親スイートのID（オプション）
使用例:
{
"name": "create_suite",
"arguments": {
"project_code": "DEMO",
"title": "認証機能テストスイート",
"description": "認証に関連する全てのテストケース",
"preconditions": "テスト用のデータベースが初期化されていること"
}
}
create_test_run
テスト実行を作成します。
入力パラメータ:
project_code: プロジェクトコード（必須）title: テスト実行のタイトル（必須）description: テスト実行の説明（オプション）cases: テスト実行に含めるテストケースのID一覧（オプション）
使用例:
{
"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（オプション）
使用例:
{
"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からのエラーレスポンス
エラーメッセージには具体的な問題と対処方法が含まれます。
開発
# 開発モードで実行（ファイル変更の監視）
npm run dev
# テストの実行
npm test
ライセンス
ISC