JinDaGe - qase-mcp-server MCP Details

article

README

🚀 Qase MCP 服务器

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

🚀 快速开始

Qase 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

qase-mcp-server