What is Qase Mcp Server

qase-mcp-server is a Model Context Protocol (MCP) server designed to integrate with the Qase test management platform, providing functionalities for creating, retrieving, and managing test cases and test executions.

Use cases

Use cases for qase-mcp-server include managing test cases for software applications, automating test execution processes, and integrating test management with CI/CD pipelines.

How to use

To use qase-mcp-server, ensure you have Node.js v23.5.0, a Qase API token, and TypeScript installed. Install the necessary packages using ‘npm install’, then build the project with ‘npm run build’. Configure the MCP settings in the ‘cline_mcp_settings.json’ file with your Qase API token and server command.

Key features

Key features of qase-mcp-server include the ability to retrieve project lists, fetch test cases, create test cases, create test suites, and initiate test runs, all through a set of defined API calls.

Where to use

qase-mcp-server can be used in software development and testing environments where test management and automation are required, particularly in projects utilizing the Qase platform.

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