Qase

🚀 Qase MCP 服务器

Qase MCP 服务器是用于与 Qase 测试管理平台进行交互的模型上下文协议（MCP）服务器，它提供了诸如测试用例创建、获取以及测试执行管理等实用功能。

🚀 快速开始

Qase 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（可选） - 指定要过滤的套件 ID

{
  "name": "get_test_cases",
  "arguments": {
    "project_code": "PRJ123"
  }
}

create_project

创建新项目。 输入参数：

• project_name：项目名称（必填）

{
  "name": "create_project",
  "arguments": {
    "project_name": "My New Project"
  }
}

update_project

更新现有项目的详细信息。 输入参数：

• project_code：要更新的项目代码（必填）
• project_name：新项目名称（可选）

{
  "name": "update_project",
  "arguments": {
    "project_code": "PRJ123",
    "project_name": "Updated Project Name"
  }
}

delete_project

删除指定项目。 输入参数：

• project_code：要删除的项目代码（必填）

{
  "name": "delete_project",
  "arguments": {
    "project_code": "PRJ123"
  }
}

📚 详细文档

错误处理

各个工具可能会返回以下类型的错误：

• 认证错误：API 令牌无效或未设置。
• 参数错误：必填参数缺失或值不正确。
• API 错误：Qase API 返回的错误响应。 错误消息将包含具体问题和解决方法。

开发

# 开发模式运行（文件更改监控）
npm run dev

# 执行测试
npm test

📄 许可证

本项目采用 ISC 许可证。