Qase MCP Server

A Model Context Protocol (MCP) server for working with Qase's test management platform, providing functions such as creating and retrieving test cases and managing test execution.

set up

Prerequisites

• Node.js v23.5.0

• Qase API Token

• TypeScript

install

# パッケージのインストール
npm install

# ビルド
npm run build

Environment settings

Add the following settings to the MCP configuration file ( 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": []
    }
  }
}

Related MCP server: TestRail MCP Server

Available Tools

get_projects

Get a list of projects.

Input parameters : None

Example usage :

{
  "name": "get_projects"
}

get_test_cases

Gets a list of test cases for a specified project.

Input parameters :

• project_code : Project code (required)

• suite_id : Suite ID (optional) - retrieves only test cases that belong to the specified suite.

Example usage :

{
  "name": "get_test_cases",
  "arguments": {
    "project_code": "DEMO",
    "suite_id": 123
  }
}

create_test_case

Create a test case.

Input parameters :

• project_code : Project code (required)

• title : The title of the test case (required)

• description : A description of the test case (optional)

Example usage :

{
  "name": "create_test_case",
  "arguments": {
    "project_code": "DEMO",
    "title": "ログイン機能のテスト",
    "description": "ユーザーログイン機能の動作確認"
  }
}

create_suite

Create a test suite.

Input parameters :

• project_code : Project code (required)

• title : The title of the test suite (required)

• description : An optional description of the test suite.

• preconditions : Preconditions for the test suite (optional)

• parent_id : The ID of the parent suite (optional)

Example usage :

{
  "name": "create_suite",
  "arguments": {
    "project_code": "DEMO",
    "title": "認証機能テストスイート",
    "description": "認証に関連する全てのテストケース",
    "preconditions": "テスト用のデータベースが初期化されていること"
  }
}

create_test_run

Create a test run.

Input parameters :

• project_code : Project code (required)

• title : The title of the test run (required)

• description : An optional description of the test run.

• cases : An optional list of test case IDs to include in the test run.

Example usage :

{
  "name": "create_test_run",
  "arguments": {
    "project_code": "DEMO",
    "title": "リグレッションテスト実行",
    "description": "v1.2.0リリース前の確認テスト",
    "cases": [1, 2, 3]
  }
}

create_test_cases_in_bulk

Create multiple test cases at once.

Input parameters :

• project_code : Project code (required)

• cases : An array of test cases to create (required)

  • title : The title of the test case (required)

  • description : A description of the test case (optional)

  • suite_id : The ID of the suite it belongs to (optional)

Example usage :

{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "ログイン成功パターン",
        "description": "正しい認証情報での確認",
        "suite_id": 123
      },
      {
        "title": "ログイン失敗パターン",
        "description": "不正な認証情報での確認",
        "suite_id": 123
      }
    ]
  }
}

Error Handling

Each tool can return the following errors:

• Authentication Error: API token is invalid or not set

• Parameter error: Required parameters are missing or have invalid values.

• API Error: Error response from Qase API

The error message will include the specific problem and how to deal with it.

development

# 開発モードで実行（ファイル変更の監視）
npm run dev

# テストの実行
npm test

license

ISC