Qase MCP Server

Un servidor MCP para interactuar con la plataforma de gestión de pruebas Qase.

GitHubPrueba este MCPPatrocinado

Documentación

Qase MCP Server

Servidor de Model Context Protocol (MCP) para integrarse con la plataforma de gestión de pruebas de Qase. Proporciona funciones como la creación de casos de prueba, la obtención de casos de prueba y la gestión de ejecuciones de prueba.

Configuración

Requisitos previos

  • Node.js v22.17.0
  • Token de API de Qase
  • TypeScript

Instalación

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

# ビルド
npm run build

Configuración del entorno

Agregue la siguiente configuración al archivo de configuración de 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": []
    }
  }
}

Herramientas disponibles

get_projects

Obtiene la lista de proyectos.

Parámetros de entrada: Ninguno

Ejemplo de uso:

{
  "name": "get_projects"
}

get_test_cases

Obtiene la lista de casos de prueba del proyecto especificado.

Parámetros de entrada:

  • project_code: Código de proyecto (obligatorio)
  • suite_id: ID de suite (opcional) - Obtiene solo los casos de prueba que pertenecen a la suite especificada

Ejemplo de uso:

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

create_test_case

Crea un caso de prueba.

Parámetros de entrada:

  • project_code: Código de proyecto (obligatorio)
  • title: Título del caso de prueba (obligatorio)
  • description: Descripción del caso de prueba (opcional)
  • preconditions: Precondiciones (opcional)
  • postconditions: Postcondiciones (opcional)
  • suite_id: ID de la suite a la que pertenece (opcional)
  • steps: Pasos de prueba (opcional)

Ejemplo de uso:

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

create_suite

Crea una suite de pruebas.

Parámetros de entrada:

  • project_code: Código de proyecto (obligatorio)
  • title: Título de la suite de pruebas (obligatorio)
  • description: Descripción de la suite de pruebas (opcional)
  • preconditions: Precondiciones de la suite de pruebas (opcional)
  • parent_id: ID de la suite principal (opcional)

Ejemplo de uso:

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

create_test_run

Crea una ejecución de prueba.

Parámetros de entrada:

  • project_code: Código de proyecto (obligatorio)
  • title: Título de la ejecución de prueba (obligatorio)
  • description: Descripción de la ejecución de prueba (opcional)
  • cases: Lista de IDs de casos de prueba a incluir en la ejecución (opcional)

Ejemplo de uso:

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

create_test_cases_in_bulk

Crea múltiples casos de prueba en lote.

Parámetros de entrada:

  • project_code: Código de proyecto (obligatorio)
  • cases: Arreglo de casos de prueba a crear (obligatorio)
    • title: Título del caso de prueba (obligatorio)
    • description: Descripción del caso de prueba (opcional)
    • steps: Pasos del caso de prueba (opcional)
      • action: Acción del paso (obligatorio)
    • suite_id: ID de la suite a la que pertenece (opcional)

Ejemplo de uso:

{
  "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

Actualiza un caso de prueba existente.

Parámetros de entrada:

  • project_code: Código de proyecto (obligatorio)
  • case_id: ID del caso de prueba (obligatorio)
  • title: Nuevo título del caso de prueba (opcional)
  • description: Nueva descripción del caso de prueba (opcional)
  • preconditions: Precondiciones (opcional)
  • postconditions: Postcondiciones (opcional)
  • severity: Severidad (0-6) (opcional)
  • priority: Prioridad (0-3) (opcional)
  • type: Tipo de prueba (opcional)
  • layer: Capa de prueba (opcional)
  • is_flaky: Si es una prueba inestable (0 o 1) (opcional)
  • suite_id: ID de la suite a la que pertenece (opcional)
  • steps: Pasos de prueba (opcional)
    • action: Acción a ejecutar (obligatorio)
    • expected_result: Resultado esperado (opcional)
    • data: Datos de prueba (opcional)

Ejemplo de uso:

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

Manejo de errores

Cada herramienta puede devolver los siguientes errores:

  • Error de autenticación: token de API inválido o no configurado
  • Error de parámetros: falta de parámetros obligatorios o valores inválidos
  • Error de API: respuesta de error de la API de Qase

Los mensajes de error incluyen el problema específico y cómo solucionarlo.

Desarrollo

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

# テストの実行
npm test

Licencia

ISC