QA-MCP

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

🇬🇧 English | 🇹🇷 Türkçe

🇬🇧 英语

📖 概述

QA-MCP 弥合了临时 LLM 提示词与结构化软件测试之间的鸿沟。它为 AI 代理和 MCP 客户端提供了共享的测试用例模型、严格的质量分析以及强大的规范化工具。

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

✨ 主要功能

• 🚀 标准化生成： 根据功能描述和验收标准自动生成高质量、结构化的测试用例。

• 🛠️ 智能规范化： 将 Gherkin、Markdown、JSON 和纯文本无缝转换为规范的 QA-MCP 模式。

• 📈 高级 Linting 与评分： 根据共享的 QA 模式评估测试用例，提供详细评分、问题跟踪和改进指导。

• 🔗 Xray 就绪： 立即将标准化测试用例转换为与 Xray 兼容的 JSON 有效负载，以便与 Jira 集成。

• 📦 套件编排： 动态编排和管理冒烟、冒烟测试 (Sanity)、回归和端到端 (E2E) 测试套件。

• 📊 覆盖率报告： 跟踪并报告跨需求、模块和风险领域的覆盖率指标。

🚀 快速入门

通过 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 接口

工具

资源

提示词

⚙️ 架构与配置

QA-MCP 专为安全、本地化执行而设计：

• 传输： 目前仅通过标准输入/输出 (stdio) 运行。

• 集成： 直接写入同步（例如 Jira/Xray API）和网络监听器已列入未来路线图里程碑。当前的 Xray 功能专注于稳健的有效负载生成。

环境变量：

🐳 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 的架构和贡献指南，请浏览文档：

• USAGE.md： 详细的使用示例和请求有效负载。

• CONTRIBUTING.md： 贡献者工作流程和质量检查。

• CHANGELOG.md： 发布历史。

• docs/PUBLISHING.md： 包和发布流程。

🗺️ 路线图

• 第一阶段（当前）： 标准模式、生成、Linting、规范化、Xray 有效负载导出以及通过 stdio 进行套件编排。

• 第二阶段（近期）： 针对混乱的现实世界输入的增强规范化逻辑、扩展的示例库以及更丰富的覆盖率报告人体工程学。

• 第三阶段（计划中）： 针对外部 QA 系统的只读集成以及严格受控、安全的写入功能端点。

📄 许可证

在 MIT 许可证下发布。详情请参阅 LICENSE。

🇹🇷 土耳其语

📖 概述

QA-MCP，在 LLM 提示词与结构化软件测试流程之间架起桥梁。它为人工智能代理和 MCP 客户端提供了一个通用的测试用例模型、严谨的质量分析和强大的规范化工具。

告别不一致且手动准备的 QA 文档。QA-MCP 确保无论是在从功能描述生成测试用例、转换 Gherkin 语法，还是创建全面的回归测试套件时，您的测试资产都能保持标准化、可重用，并与您的软件团队完美协调。

✨ 主要功能

• 🚀 标准化生成： 根据功能文本和验收标准自动生成高质量、结构化的测试用例。

• 🛠️ 智能规范化： 将 Gherkin、Markdown、JSON 和纯文本无缝转换为标准的 QA-MCP 模式。

• 📈 高级 Linting 与评分： 根据通用质量模式评估测试用例；获取详细评分、错误和改进步骤。

• 🔗 Xray 集成就绪： 立即将标准测试用例转换为与 Jira/Xray 兼容的 JSON 有效负载。

• 📦 套件管理： 动态创建和管理冒烟、冒烟测试 (Sanity)、回归和端到端 (E2E) 测试套件。

• 📊 覆盖率报告： 报告基于需求、模块和风险的测试覆盖率指标。

🚀 快速入门

通过 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 接口

工具

资源

提示词

⚙️ 架构与配置

QA-MCP 专为安全和本地运行而设计：

• 传输： 目前仅通过标准输入/输出 (stdio) 运行。

• 集成： 具有直接写入权限的 API 同步（例如直接推送到 Jira/Xray）和网络监听器已列入未来路线图。当前的 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

📚 文档

有关架构细节和项目贡献指南，请参阅：

• USAGE.md： 详细的使用示例和请求有效负载。

• CONTRIBUTING.md： 贡献流程和质量检查。

• CHANGELOG.md： 版本和变更历史。

• docs/PUBLISHING.md： 包和发布流程。

🗺️ 路线图

• 第一阶段（当前）： 通过 stdio 进行标准模式、生成、Linting、规范化、Xray 导出和套件编排。

• 第二阶段（近期）： 针对混乱输入的改进规范化逻辑、更丰富的示例库以及改进的报告人体工程学。

• 第三阶段（计划中）： 针对外部 QA 系统的只读集成以及受控/安全的写入功能端点。

📄 许可证

在 MIT 许可证下发布。详情请参阅 LICENSE 文件。