Qase Test Management MCP Server

Overview

The Qase Test Management MCP Server is a Model Context Protocol (MCP) server designed to integrate with Qase's test management platform. It provides functionalities for creating and retrieving test cases, managing test runs, and more.

Setup

Prerequisites

• Node.js v23.5.0
• Qase API Token
• TypeScript

Installation

# Install packages
npm install

# Build the project
npm run build

Environment Configuration

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

Available Tools

get_projects

Retrieves a list of projects.

Input Parameters: None

Example:

{
  "name": "get_projects"
}

get_test_cases

Retrieves a list of test cases for a specified project.

Input Parameters:
- project_code: Project code (required)
- suite_id: Suite ID (optional) - Only retrieves test cases belonging to the specified suite

Example:

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

create_test_case

Creates a new test case.

Input Parameters:
- project_code: Project code (required)
- title: Test case title (required)
- description: Test case description (optional)

Example:

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

create_suite

Creates a new test suite.

Input Parameters:
- project_code: Project code (required)
- title: Test suite title (required)
- description: Test suite description (optional)
- preconditions: Test suite preconditions (optional)
- parent_id: Parent suite ID (optional)

Example:

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

create_test_run

Creates a new test run.

Input Parameters:
- project_code: Project code (required)
- title: Test run title (required)
- description: Test run description (optional)
- cases: List of test case IDs to include in the test run (optional)

Example:

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

create_test_cases_in_bulk

Creates multiple test cases in bulk.

Input Parameters:
- project_code: Project code (required)
- cases: Array of test cases to create (required)
- title: Test case title (required)
- description: Test case description (optional)
- suite_id: Suite ID (optional)

Example:

{
  "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 may return the following types of errors:
- Authentication Error: Invalid or missing API token
- Parameter Error: Missing or invalid required parameters
- API Error: Error response from Qase API

Error messages include specific issues and troubleshooting steps.

Development

# Run in development mode (watches for file changes)
npm run dev

# Run tests
npm test

License

ISC