Qase MCP Server

🚀 Qase MCP サーバー

Qaseのテスト管理プラットフォームのModel Context Protocol (MCP) サーバーです。テストケースの作成、取得、テスト実行の管理などの機能を提供します。

🚀 クイックスタート

このサーバーを使用することで、Qaseのテスト管理プラットフォームでテストケースを簡単に管理できます。

📦 インストール

前提条件

• 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_test_cases_in_bulk

複数のテストケースを一括で作成します。 入力パラメータ:

• project_code: プロジェクトコード（必須）
• cases: テストケースの配列（各オブジェクトには title とオプションの description が含まれます）

{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "ログイン成功シナリオ",
        "description": "有効な資格情報で検証する"
      },
      {
        "title": "ログイン失敗シナリオ",
        "description": "無効な資格情報で検証する"
      }
    ]
  }
}

🔧 技術詳細

各ツールでは、以下のエラーが発生する可能性があります。

• 認証エラー: APIトークンが無効または設定されていない場合
• パラメータエラー: 必須パラメータが欠落しているか、値が正しくない場合
• APIエラー: Qase APIからエラー応答が返される場合

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

🔧 開発ガイド

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

# テストの実行
npm test

📄 ライセンス

ISC