Qase MCP Server

Servidor MCP de Qase

Servidor de Protocolo de Contexto de Modelo (MCP) para integrarse con la plataforma de gestión de pruebas de Qase. Proporciona funcionalidades como creación de casos de prueba, obtención de casos de prueba y gestión de ejecuciones de pruebas.

Configuración

Requisitos previos

• Node.js v23.5.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 para el proyecto especificado.

Parámetros de entrada:

• project_code: Código del proyecto (obligatorio)
• suite_id: ID del conjunto (opcional) - Obtiene solo los casos de prueba que pertenecen al conjunto especificado

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 del proyecto (obligatorio)
• title: Título del caso de prueba (obligatorio)
• description: Descripción del caso de prueba (opcional)

Ejemplo de uso:

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

create_suite

Crea un conjunto de pruebas.

Parámetros de entrada:

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

Ejemplo de uso:

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

create_test_run

Crea una ejecución de pruebas.

Parámetros de entrada:

• project_code: Código del proyecto (obligatorio)
• title: Título de la ejecución de pruebas (obligatorio)
• description: Descripción de la ejecución de pruebas (opcional)
• cases: Lista de IDs de casos de prueba a incluir en la ejecución de pruebas (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 de forma masiva.

Parámetros de entrada:

• project_code: Código del proyecto (obligatorio)
• cases: Matriz de casos de prueba a crear (obligatorio)
  • title: Título del caso de prueba (obligatorio)
  • description: Descripción del caso de prueba (opcional)
  • suite_id: ID del conjunto al que pertenece (opcional)

Ejemplo de uso:

{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "ログイン成功パターン",
        "description": "正しい認証情報での確認",
        "suite_id": 123
      },
      {
        "title": "ログイン失敗パターン",
        "description": "不正な認証情報での確認",
        "suite_id": 123
      }
    ]
  }
}

Manejo de errores

Cada herramienta puede devolver los siguientes tipos de errores:

• Error de autenticación: Token de API inválido o no configurado
• Error de parámetros: Parámetros obligatorios faltantes 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 resolverlo.

Desarrollo

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

# テストの実行
npm test

Licencia

ISC