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