qatouch

QA Touch MCP 服务

QA Touch 的官方 Model Context Protocol（MCP）服务。

QA Touch 是一个现代化的测试管理平台，用于管理项目、测试用例、测试运行、执行结果、缺陷、需求、发布和 QA 报告。此 MCP 服务可让兼容 MCP 的 AI 助手通过安全的工具接口与 QA Touch 交互。

QA Touch - Claude 技能仓库 - https://github.com/qatouch/qatouch-claude-skills

功能

• 列出并统计 QA Touch 项目
• 创建项目
• 列出并搜索测试用例
• 创建结构化、批量、探索式和文本模板测试用例
• 列出、统计、搜索并创建模块
• 列出、统计、搜索并创建发布/里程碑
• 列出、统计、搜索并创建需求和需求文档
• 列出、统计、搜索并创建缺陷
• 列出缺陷状态、严重程度、问题类型和环境
• 列出测试运行、测试运行结果、结果历史记录和可用状态
• 更新单个或批量测试运行结果的状态
• 列出可用于测试执行的用户
• 跨项目搜索测试用例、模块、需求、缺陷和发布
• 列出 QA Touch 工作区

要求

• Node.js 18+
• npm
• QA Touch API 令牌
• QA Touch 域名

安装

使用 npx 直接运行：

npx -y qatouch-mcp-server

或全局安装：

npm install -g qatouch-mcp-server
qatouch-mcp-server

此服务需要以下环境变量：

QATOUCH_DOMAIN=yourdomain
QATOUCH_API_TOKEN=yourtoken

Claude Desktop 设置

将此服务添加到 Claude Desktop MCP 配置中。

Windows 配置位置：

%APPDATA%\Claude\claude_desktop_config.json

macOS 配置位置：

~/Library/Application Support/Claude/claude_desktop_config.json

Linux 配置位置：

~/.config/Claude/claude_desktop_config.json

配置：

{
  "mcpServers": {
    "qatouch": {
      "command": "npx",
      "args": [
        "-y",
        "qatouch-mcp-server"
      ],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

保存文件后，重启 Claude Desktop。

可用工具

工具	描述
count_all_projects	获取该域名下可用 QA Touch 项目的总数
count_defects	获取 QA Touch 项目中缺陷的总数
count_modules	获取 QA Touch 项目中模块的总数
count_releases	获取 QA Touch 项目中发布的总数
count_requirements	获取 QA Touch 项目中需求的总数
count_test_cases	获取 QA Touch 项目中测试用例的总数
count_test_runs	获取 QA Touch 项目中测试运行的总数
create_bulk_test_cases	根据场景创建多个 QA Touch 测试用例
create_defect	创建包含优先级和问题摘要的 QA Touch 缺陷
create_exploratory_test_case	创建不含结构化步骤的 QA Touch 探索性会话测试用例
create_module	在 QA Touch 项目中创建模块
create_project	创建新的 QA Touch 项目
create_release	在 QA Touch 项目中创建新的发布或里程碑
create_requirement	在 QA Touch 项目需求文档中创建需求
create_requirement_document	在 QA Touch 项目中创建需求文档
create_test_run_with_modules	通过选择一个或多个模块键来创建新的测试运行
create_test_case	创建包含结构化步骤的 QA Touch 测试用例
create_text_test_case	使用文本模板端点创建 QA Touch 测试用例
import_test_cases	使用 CSV 文件将测试用例导入 QA Touch 项目
list_defect_environments	列出 QA Touch 缺陷的所有可用环境
list_defect_issue_types	列出 QA Touch 缺陷的所有可用问题类型
list_defect_severities	列出 QA Touch 缺陷的所有可用严重程度
list_defect_statuses	列出 QA Touch 缺陷的所有可用状态
list_defects	获取项目中的所有缺陷
list_modules	获取项目中的所有模块
list_projects	检索所有 QA Touch 项目
list_releases	获取项目中的所有发布
list_requirement_documents	列出 QA Touch 项目的需求文档
list_requirements	获取项目中的所有需求
list_test_cases	获取项目中的所有测试用例
list_test_run_available_users	列出 QA Touch 项目中可参与测试的用户
list_test_run_result_history	列出 QA Touch 测试运行结果的历史记录
list_test_run_results	列出 QA Touch 测试运行的所有结果
list_test_run_statuses	列出 QA Touch 测试运行的所有可用状态
list_test_runs	获取项目中的所有测试运行
list_workspace	列出该域名下所有可用的 QA Touch 工作区
search_defects	获取项目缺陷并搜索问题摘要
search_modules	获取项目模块并搜索模块名称
search_project	搜索项目中的测试用例、模块、需求、缺陷和发布
search_releases	获取项目发布并搜索里程碑名称
search_requirements	获取项目需求并搜索标题和描述
search_test_cases	获取项目中的所有测试用例并搜索测试用例标题和描述
update_test_run_result_status	更新单个 QA Touch 测试运行结果的状态
update_test_run_results_by_code	根据测试用例代码批量更新 QA Touch 测试运行结果的状态

示例提示词

• 列出所有 QA Touch 项目
• 统计所有 QA Touch 项目的数量
• 创建一个名为 Mobile App Regression 的项目
• 显示项目 ABC 中的测试用例
• 搜索项目 ABC 中包含“login”的测试用例
• 在项目 ABC 的 AUTH 分区下创建一个登录测试用例
• 在项目 ABC 的 CHECKOUT 分区下创建 8 个结账回归测试用例
• 将 /path/to/testcases.csv 中的测试用例导入项目 ABC
• 列出项目 ABC 中的模块
• 在项目 ABC 中创建一个名为 Payment Gateway 的模块
• 列出项目 ABC 中的发布版本
• 在项目 ABC 中创建发布版本“June Regression”
• 列出项目 ABC 中的需求
• 搜索项目 ABC 中包含“password reset”的需求
• 列出项目 ABC 中的需求文档
• 在项目 ABC 中为发布版本 REL1 创建一个名为 Login Requirements 的需求文档
• 在文档 DOC1 中创建一个有效登录需求
• 列出项目 ABC 中的缺陷
• 显示项目 ABC 中优先级较高的缺陷
• 搜索项目 ABC 中包含“timeout”的缺陷
• 在项目 ABC 中创建一个关于结账支付超时的高优先级缺陷
• 列出项目 ABC 中的测试运行
• 在项目“v7Nz”中创建一个名为“Regression Run”的测试运行，使用模块“2BQXR”和“VeRDL”，将其分配给用户“M7”，并归入里程碑“0DLB”
• 显示项目 ABC 中测试运行 RUN1 的结果
• 显示测试运行 RUN1 中结果 RES1 的历史记录
• 列出可用的测试运行状态
• 将项目 ABC 中测试运行 RUN1 的结果 RES1 标记为失败
• 在测试运行 RUN1 中，将 TC-101 批量更新为通过，将 TC-102 批量更新为受阻
• 列出项目 ABC 中可用的测试人员
• 在项目 ABC 中搜索“login”
• 为项目 ABC 生成 QA 状态报告
• 找出测试运行 RUN1 中尚未执行的测试用例
• 更多📖提示词示例：how_to_use.txt

开发

安装依赖：

npm install

在本地运行 MCP 服务：

npm start

在本地运行时需要设置环境变量：

QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken npm start

此代码库目前仅在 package.json 中定义了 start 脚本。

项目结构

src/
  api/          QA Touch API client
  config/       Environment variable validation
  tools/        MCP tool definitions and handlers
  index.js      MCP server entry point and tool registration
examples/       Prompt and client setup examples

贡献

欢迎贡献。有关开发工作流、编码规范和拉取请求指南，请参阅 CONTRIBUTING.md。

许可证

本项目采用 MIT License 许可。