MCP Test Generator

QA-MCP

 ](https://pypi.org/project/qa-mcp/)   ](https://hub.docker.com/r/atakanemree/qa-mcp)

用于确定性、结构化和可扩展质量保证的模型上下文协议（MCP）服务器。

🇬🇧 英语 | 🇹🇷 土耳其语

______________________________________________________________________

🇬🇧 英语

📖 概述

QA-MCP 弥合了即席LLM提示和结构化软件测试之间的差距。它为AI代理和MCP客户端提供了一个共享的测试用例模型、严格的质量分析和强大的规范化工具。

与不一致的手动QA文件说再见。QA-MCP确保无论您是从原始特征描述生成测试用例、转换Gherkin语法，还是编写完整的回归套件，您的测试工件都保持标准化、可重用，并在您的工程团队中完美对齐。

✨ 主要特点

• 🚀 标准化生成： 根据功能描述和验收标准自动生成高质量、结构化的测试用例。
• 🛠️ 智能标准化： 无缝地将Gherkin、Markdown、JSON和纯文本转换为规范的QA-MCP模式。
• 📈 高级皮绒与计分： 根据共享的QA模式评估测试用例，包括详细的分数、问题跟踪和改进指导。
• 🔗 X射线就绪： 立即将标准化测试用例转换为与X射线兼容的JSON有效载荷，以实现Jira集成。
• 📦 套房组成： 动态组合和管理Smoke、Sanity、Regression和E2E测试套件。
• 📊 覆盖范围报告： 跟踪和报告跨需求、模块和风险领域的覆盖率指标。

🚀 快速开始

通过PyPI安装

pip install qa-mcp
qa-mcp --version

通过紫外线安装

pip install uv
uv pip install qa-mcp
qa-mcp --version

通过Docker运行

docker pull atakanemree/qa-mcp:latest
docker run -i --rm atakanemree/qa-mcp:latest

🔌 连接MCP客户端

配置您首选的MCP客户端（例如Claude Desktop）以使用QA-MCP。

标准配置：

{
  "mcpServers": {
    "qa-mcp": {
      "command": "qa-mcp",
      "args": []
    }
  }
}

Docker配置：

{
  "mcpServers": {
    "qa-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "atakanemree/qa-mcp:latest"]
    }
  }
}

🛠️ 公共MCP表面

工具

工具名称故意使用下划线，以便Claude Desktop和其他严格的MCP客户端接受它们。

资源

提示

⚙️ 架构和配置

QA-MCP旨在实现安全、本地化的执行：

• 运输： 目前仅通过标准输入/输出进行操作(stdio).
• 集成： 计划在未来的路线图里程碑中实现可直接写入的同步（例如Jira/Xray API）和网络侦听器。当前的X射线功能侧重于强大的有效载荷生成。

环境变量：

🐳 Docker部署

官方镜像可以在Docker Hub上找到： atakanemree/qa-mcp

# Verify the packaged CLI
docker run --rm atakanemree/qa-mcp:latest --version

# Run the MCP server in stdio mode
docker run -i --rm atakanemree/qa-mcp:latest

# Docker Compose usage
docker compose up qa-mcp
docker compose --profile dev up qa-mcp-dev

📚 文档

要深入了解QA-MCP的架构和贡献指南，请浏览以下文档：

• 用法.md: 详细的使用示例和请求有效载荷。
• 贡献.md: 贡献者工作流程和质量检查。
• 更改日志.md: 释放历史。
• docs/PUBLISHING.md: 打包和发布发布流程。

🗺️ 路线图

• 第1阶段（当前）： 标准模式、生成、linting、规范化、X射线有效载荷导出和套件组合 stdio.
• 第二阶段（近期）： 增强了混乱的现实世界输入的规范化逻辑，扩展了示例库，并提供了更丰富的覆盖率报告人体工程学。
• 第三阶段（计划中）： 外部QA系统和严格门控、安全可写端点的只读集成。

📄 许可证

根据 MIT许可证。参见 许可证 了解详情。

______________________________________________________________________

🇹🇷 土耳其语

📖 概述

QA-MCP建立LLM请求（提示符）和配置软件测试过程之间的桥梁。它为人工智能代理和MCP客户提供了共同的测试场景模型，严格的质量分析和强大的标准化工具。

告别不一致和手动生成的QA文档。QA-MCP；从原始属性定义生成测试案例，转换Gherkin语法或创建全面回归套件时，您的测试实体的标准，可重复使用，并确保软件与您的团队完美兼容。

✨ 基本特点

• 🚀 标准生产： 从功能文本和接受标准自动生成高质量的配置测试案例。
• 🛠️ 智能标准化： 将Gherkin、Markdown、JSON和纯文本无缝转换为标准QA-MCP方案。
• 📈 高级Linting和评分： 根据共同质量方案评估测试场景；获取详细的分数，错误和改进步骤。
• 🔗 准备Xray集成： 立即将标准测试案例转换为兼容 Jira/Xray 的 JSON 有效负载。
• 📦 套房管理： 动态创建和管理 Smoke、Sanity、Regression 和 E2E 测试套件。
• 📊 Kapsam（报道）Raporlama： 报告基于模块和风险的测试范围指标。

🚀 快速入门

通过PyPI安装

pip install qa-mcp
qa-mcp --version

与UV安装

pip install uv
uv pip install qa-mcp
qa-mcp --version

使用 Docker

docker pull atakanemree/qa-mcp:latest
docker run -i --rm atakanemree/qa-mcp:latest

🔌 连接到MCP客户端

将首选的 MCP 客户端（例如 Claude Desktop）配置为使用 QA-MCP。

标准配置 ：

{
  "mcpServers": {
    "qa-mcp": {
      "command": "qa-mcp",
      "args": []
    }
  }
}

Docker 配置：

{
  "mcpServers": {
    "qa-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "atakanemree/qa-mcp:latest"]
    }
  }
}

🛠️ 公共MCP表面

工具（Tools）

有意识地强调工具名称，以便与诸如Claude Desktop之类的严格MCP客户端兼容（_）使用。

资源（Resources）

Prompt'lar

⚙️ 建筑与配置

QA-MCP 旨在安全和本地运行：

• 交通（Transport）： 目前只有标准输入/输出（stdio）通过工作。
• 集成： 具有直接写权限的 API 同步（例如直接推送到 Jira/Xray）和网络监听器（network listeners）已在未来的路线图中计划。目前的Xray功能专注于产生强大的有效载荷。

环境变量 ：

🐳 Docker 发布

官方图像发布在Docker Hub上： atakanemree/qa-mcp

# Paketlenmiş CLI'yı doğrula
docker run --rm atakanemree/qa-mcp:latest --version

# MCP server'ı stdio modunda çalıştır
docker run -i --rm atakanemree/qa-mcp:latest

# Docker Compose kullanımı
docker compose up qa-mcp
docker compose --profile dev up qa-mcp-dev

📚 文档

有关建筑细节和项目贡献指南：

• 用法.md: 详细的使用示例和请求payloads。
• 贡献.md: 投入流和质量控制。
• 更改日志.md: 版本和变化的历史。
• docs/PUBLISHING.md: 包和发布过程。

🗺️ 路线图

• 步骤1（现有）： stdio 通过标准方案， 制造， linting， 标准化， X射线导出和套件组成.
• 第二阶段（短期）： 针对分散输入改进的标准化逻辑，更丰富的示例库和改进的报告人体工程学。
• 第三步（计划）： 用于外部QA系统的只读集成和可控/安全写入端点。

📄 许可证

MIT许可证 与发布。了解详情 许可证 你可以查看文件。