Qase MCP 服务器

Qase 测试管理平台集成的 Model Context Protocol (MCP) 服务器。 提供测试用例的创建、获取、测试执行管理等功能。

设置

前提条件

• Node.js v23.5.0
• Qase API Token
• 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（可选）- 仅获取属于指定测试套件的测试用例

使用示例:

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

create_test_case

创建测试用例。

输入参数:

• project_code: 项目代码（必需）
• title: 测试用例标题（必需）
• description: 测试用例描述（可选）

使用示例:

{
  "name": "create_test_case",
  "arguments": {
    "project_code": "DEMO",
    "title": "登录功能测试",
    "description": "用户登录功能的操作确认"
  }
}

create_suite

创建测试套件。

输入参数:

• project_code: 项目代码（必需）
• title: 测试套件标题（必需）
• description: 测试套件描述（可选）
• preconditions: 测试套件的前提条件（可选）
• parent_id: 父套件的 ID（可选）

使用示例:

{
  "name": "create_suite",
  "arguments": {
    "project_code": "DEMO",
    "title": "认证功能测试套件",
    "description": "所有与认证相关的测试用例",
    "preconditions": "测试用数据库已初始化"
  }
}

create_test_run

创建测试执行。

输入参数:

• project_code: 项目代码（必需）
• title: 测试执行标题（必需）
• description: 测试执行描述（可选）
• cases: 包含在测试执行中的测试用例 ID 列表（可选）

使用示例:

{
  "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: 测试用例描述（可选）
  • suite_id: 所属套件的 ID（可选）

使用示例:

{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "登录成功场景",
        "description": "使用正确的认证信息进行确认",
        "suite_id": 123
      },
      {
        "title": "登录失败场景",
        "description": "使用不正确的认证信息进行确认",
        "suite_id": 123
      }
    ]
  }
}

错误处理

每个工具可能会返回以下错误：

• 认证错误：API Token 无效或未设置
• 参数错误：缺少必需参数或参数值不正确
• API 错误：来自 Qase API 的错误响应

错误消息包含具体的问题和解决方法。

开发

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

# 运行测试
npm test

许可证

ISC