Qase MCP 服务器

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

安装步骤

先决条件

• 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（可选）—— 获取指定套件中的所有测试用例

示例:

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

批量创建多个测试用例。

输入参数:

• project_code: 项目代码（必填）
• cases: 测试用例数组（每个对象包含 title 和可选的 description）

示例:

{
  "name": "create_test_cases_in_bulk",
  "arguments": {
    "project_code": "DEMO",
    "cases": [
      {
        "title": "登录成功场景",
        "description": "使用有效凭证进行验证"
      },
      {
        "title": "登录失败场景",
        "description": "使用无效凭证进行验证"
      }
    ]
  }
}

错误处理

各个工具可能遇到以下错误：

• 认证错误: API令牌无效或未设置
• 参数错误: 必填参数缺失或值不正确
• API错误: Qase API 返回的错误响应

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

开发指南

# 以开发模式运行（监控文件变化）
npm run dev

# 执行测试
npm test

许可证

ISC