# 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