qa-touch-mcp

MCP（模型上下文协议）服务器，用于 QA Touch 测试管理 API。让类似 Claude 的 AI 助手能够在您的 QA Touch 域中浏览项目、管理测试用例、驱动测试运行、记录结果并提交缺陷。

Requirements

• Node.js 18+

• 拥有 Professional 或 Enterprise 套餐的 QA Touch 帐户（API 仅对这些套餐开放）

• API 令牌：在 QA Touch 中，前往 Profile → Edit Profile → Generate API Key

Related MCP server: Testmo MCP Server

Configuration

服务器完全通过环境变量进行配置：

该令牌可访问您 QA Touch 域中的所有数据。请勿将其纳入版本控制。

Install

Claude Code

claude mcp add qa-touch --env QATOUCH_DOMAIN=yourdomain --env QATOUCH_API_TOKEN=yourtoken -- npx qa-touch-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "qa-touch": {
      "command": "npx",
      "args": ["qa-touch-mcp"],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

From source

npm install
npm run build
QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken node dist/index.js

Tools（32）

Projects — list_projects, get_project, create_project

Test cases & modules — list_test_cases（可按审批状态、模块、模式或需求筛选）, get_test_case, get_test_case_steps, list_modules, create_module, create_test_case（探索性 / 文本 / BDD / 步骤模板）, update_test_case, import_test_cases_csv

Releases & plans — list_releases, create_release, list_test_plans, list_workspaces

Test runs & results — list_test_runs, get_test_run, create_test_run（全部用例 / 指定用例 / 按模块）, clone_test_run, list_test_run_results（按运行、版本、历史或用例）, get_test_run_metadata, update_test_result, update_test_result_steps, bulk_update_test_results, update_test_results_multi, add_test_result（含附件）

Defects — list_defects, create_defect（含附件）, get_defect_metadata

Requirements — list_requirements, create_requirement_document, create_requirement

Behavior notes

• Rate limiting：QA Touch 允许每分钟 50 个请求。服务器在客户端进行限流，并在收到 429 时重试一次，同时遵循 Retry-After。

• Pagination：列表工具接受 page 参数。QA Touch API 在第 1 页将 meta.current_page/last_page 返回为 null；服务器会对此进行归一化，并添加 has_next 标志。

• Attachments：png、pdf、jpg、jpeg、gif、xls、xlsx、doc、docx、csv、log、zip、txt —— 每个文件最大 2 MB，上传前会进行验证。

• Batch limits：多用例状态更新每次调用最多 20 条，因为 API 在 URL 中接收参数，并且会拒绝过长的 URI。

Development

npm run build   # compile TypeScript
npm test        # run unit tests (vitest)

本实现所使用的 API 参考说明：docs/qatouch-api-reference.md。