🚀 Qase MCP 服务器实现

这是一个基于 TypeScript 的 MCP 服务器，专为 Qase 测试管理平台打造。它实现了 MCP 的核心概念，提供了与 Qase API 集成的功能，让你可以方便地管理各类 Qase 实体。

🚀 快速开始

本服务器是 Qase 测试管理平台的 MCP 服务器实现，基于 TypeScript 构建，集成 Qase API，能帮助你高效管理 Qase 中的各类实体。

✨ 主要特性

工具

该服务器提供了一系列用于与 Qase API 交互的工具，可管理以下实体：

项目

• list_projects - 获取所有项目
• get_project - 根据代码获取项目
• create_project - 创建新项目
• delete_project - 根据代码删除项目

测试用例

• get_cases - 获取项目中的所有测试用例
• get_case - 获取特定的测试用例
• create_case - 创建新的测试用例
• update_case - 更新现有的测试用例

测试运行

• get_runs - 获取项目中的所有测试运行
• get_run - 获取特定的测试运行

测试结果

• get_results - 获取项目中的所有测试运行结果
• get_result - 根据代码和哈希获取测试运行结果
• create_result - 创建新的测试运行结果
• create_result_bulk - 批量创建多个测试运行结果
• update_result - 更新现有的测试运行结果

测试计划

• get_plans - 获取项目中的所有测试计划
• get_plan - 获取特定的测试计划
• create_plan - 创建新的测试计划
• update_plan - 更新现有的测试计划
• delete_plan - 删除测试计划

测试套件

• get_suites - 获取项目中的所有测试套件
• get_suite - 获取特定的测试套件
• create_suite - 创建新的测试套件
• update_suite - 更新现有的测试套件
• delete_suite - 删除测试套件

共享步骤

• get_shared_steps - 获取项目中的所有共享步骤
• get_shared_step - 获取特定的共享步骤
• create_shared_step - 创建新的共享步骤
• update_shared_step - 更新现有的共享步骤
• delete_shared_step - 删除共享步骤

📦 安装指南

开发环境安装

安装依赖

npm install

构建服务器

npm run build

带有自动重建的开发

npm run watch

与其他工具集成安装

Claude Desktop

要与 Claude Desktop 使用，需添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-qase": {
      "command": "/path/to/mcp-qase/build/index.js",
      "env": {
        "QASE_API_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Cursor

要与 Cursor 使用，注册命令如下：

env QASE_API_TOKEN=<YOUR_TOKEN> /path/to/mcp-qase/build/index.js

🔧 技术细节

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们推荐使用 MCP Inspector 进行调试：

npx -y @modelcontextprotocol/inspector -e QASE_API_TOKEN=<YOUR_TOKEN> ./build/index.js