🚀 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