Qase MCP Server

Qase MCP Server

Servidor Model Context Protocol (MCP) para integração com a plataforma de gerenciamento de testes da Qase. Oferece funcionalidades como criação e obtenção de casos de teste, e gerenciamento de execuções de teste.

Configuração

Pré-requisitos

• Node.js v23.5.0
• Token da API Qase
• TypeScript

Instalação

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

# ビルド
npm run build

Configuração de ambiente

Adicione as seguintes configurações ao arquivo de configuração do 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": []
    }
  }
}

Ferramentas disponíveis

get_projects

Obtém a lista de projetos.

Parâmetros de entrada: Nenhum

Exemplo de uso:

{
  "name": "get_projects"
}

get_test_cases

Obtém a lista de casos de teste do projeto especificado.

Parâmetros de entrada:

• project_code: código do projeto (obrigatório)
• suite_id: ID da suíte (opcional) - obtém apenas os casos de teste pertencentes à suíte especificada

Exemplo de uso:

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

create_test_case

Cria um caso de teste.

Parâmetros de entrada:

• project_code: código do projeto (obrigatório)
• title: título do caso de teste (obrigatório)
• description: descrição do caso de teste (opcional)

Exemplo de uso:

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

create_suite

Cria uma suíte de testes.

Parâmetros de entrada:

• project_code: código do projeto (obrigatório)
• title: título da suíte de testes (obrigatório)
• description: descrição da suíte de testes (opcional)
• preconditions: pré-condições da suíte de testes (opcional)
• parent_id: ID da suíte pai (opcional)

Exemplo de uso:

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

create_test_run

Cria uma execução de teste.

Parâmetros de entrada:

• project_code: código do projeto (obrigatório)
• title: título da execução de teste (obrigatório)
• description: descrição da execução de teste (opcional)
• cases: lista de IDs dos casos de teste a incluir na execução de teste (opcional)

Exemplo de uso:

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

create_test_cases_in_bulk

Cria vários casos de teste em lote.

Parâmetros de entrada:

• project_code: código do projeto (obrigatório)
• cases: matriz de casos de teste a criar (obrigatório)
  • title: título do caso de teste (obrigatório)
  • description: descrição do caso de teste (opcional)
  • suite_id: ID da suíte à qual pertence (opcional)

Exemplo de uso:

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

Tratamento de erros

Cada ferramenta pode retornar os seguintes tipos de erro:

• Erro de autenticação: token da API inválido ou não definido
• Erro de parâmetro: parâmetros obrigatórios ausentes ou valores inválidos
• Erro de API: resposta de erro da API Qase

As mensagens de erro incluem o problema específico e como resolvê-lo.

Desenvolvimento

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

# テストの実行
npm test

Licença

ISC