trackmcp
Back to directory
hacobell-inc

qase-mcp-server

View on GitHub

Qase MCP Server

0 stars JavaScriptOthers Updated Dec 22, 2025
hacobell

Documentation

Qase MCP Server

Qaseのテスト管理プラットフォームと連携するためのModel Context Protocol (MCP) サーバーです。

テストケースの作成、取得、テスト実行の管理などの機能を提供します。

セットアップ

前提条件

  • Node.js v22.17.0
  • Qase APIトークン
  • TypeScript

インストール

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

# ビルド
npm run build

環境設定

MCPの設定ファイル(`cline_mcp_settings.json`)に以下の設定を追加します:

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

プロジェクト一覧を取得します。

入力パラメータ: なし

使用例:

json
{
  "name": "get_projects"
}

get_test_cases

指定したプロジェクトのテストケース一覧を取得します。

入力パラメータ:

  • `project_code`: プロジェクトコード(必須)
  • `suite_id`: スイートID(オプション)- 指定したスイートに属するテストケースのみを取得

使用例:

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

create_test_case

テストケースを作成します。

入力パラメータ:

  • `project_code`: プロジェクトコード(必須)
  • `title`: テストケースのタイトル(必須)
  • `description`: テストケースの説明(オプション)
  • `preconditions`: 前提条件(オプション)
  • `postconditions`: 事後条件(オプション)
  • `suite_id`: 所属するスイートのID(オプション)
  • `steps`: テストステップ(オプション)

使用例:

json
{
  "name": "create_test_case",
  "arguments": {
    "project_code": "DEMO",
    "title": "ログイン機能のテスト",
    "description": "ユーザーログイン機能の動作確認",
    "preconditions": "テストユーザーアカウントが作成済みであること",
    "steps": [
      {
        "action": "ログインページにアクセス",
        "expected_result": "ログインフォームが表示される"
      }
    ]
  }
}

create_suite

テストスイートを作成します。

入力パラメータ:

  • `project_code`: プロジェクトコード(必須)
  • `title`: テストスイートのタイトル(必須)
  • `description`: テストスイートの説明(オプション)
  • `preconditions`: テストスイートの前提条件(オプション)
  • `parent_id`: 親スイートのID(オプション)

使用例:

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

create_test_run

テスト実行を作成します。

入力パラメータ:

  • `project_code`: プロジェクトコード(必須)
  • `title`: テスト実行のタイトル(必須)
  • `description`: テスト実行の説明(オプション)
  • `cases`: テスト実行に含めるテストケースのID一覧(オプション)

使用例:

json
{
  "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`: テストケースの説明(オプション)
    • `steps`: テストケースの手順(オプション)
      • `action`: 手順のアクション(必須)
    • `suite_id`: 所属するスイートのID(オプション)

使用例:

json
{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "ログイン成功パターン",
        "description": "正しい認証情報での確認",
        "steps": [
          {
            "action": "ログインページにアクセス"
          },
          {
            "action": "正しいユーザー名とパスワードを入力"
          }
        ],
        "suite_id": 123
      },
      {
        "title": "ログイン失敗パターン",
        "description": "不正な認証情報での確認",
        "suite_id": 123
      }
    ]
  }
}

update_test_case

既存のテストケースを更新します。

入力パラメータ:

  • `project_code`: プロジェクトコード(必須)
  • `case_id`: テストケースのID(必須)
  • `title`: テストケースの新しいタイトル(オプション)
  • `description`: テストケースの新しい説明(オプション)
  • `preconditions`: 前提条件(オプション)
  • `postconditions`: 事後条件(オプション)
  • `severity`: 重要度 (0-6)(オプション)
  • `priority`: 優先度 (0-3)(オプション)
  • `type`: テストタイプ(オプション)
  • `layer`: テストレイヤー(オプション)
  • `is_flaky`: 不安定なテストかどうか (0 or 1)(オプション)
  • `suite_id`: 所属するスイートのID(オプション)
  • `steps`: テストステップ(オプション)
    • `action`: 実行するアクション(必須)
    • `expected_result`: 期待される結果(オプション)
    • `data`: テストデータ(オプション)

使用例:

json
{
  "name": "update_test_case",
  "arguments": {
    "project_code": "DEMO",
    "case_id": 456,
    "title": "更新されたログイン機能のテスト",
    "description": "ユーザーログイン機能の詳細な動作確認",
    "severity": 2,
    "priority": 1,
    "steps": [
      {
        "action": "ログインページにアクセスする",
        "expected_result": "ログインフォームが表示される"
      },
      {
        "action": "有効な認証情報を入力してログインボタンをクリック",
        "expected_result": "ダッシュボードページにリダイレクトされる"
      }
    ]
  }
}

エラーハンドリング

各ツールは以下のようなエラーを返す可能性があります:

  • 認証エラー: APIトークンが無効または未設定
  • パラメータエラー: 必須パラメータの不足や不正な値
  • APIエラー: Qase APIからのエラーレスポンス

エラーメッセージには具体的な問題と対処方法が含まれます。

開発

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

# テストの実行
npm test

ライセンス

ISC

Frequently asked questions

What is qase-mcp-server?

qase-mcp-server is Qase MCP Server

How do I install qase-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is qase-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/hacobell-inc/qase-mcp-server.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP