QA-MCP: Test Standardization & Orchestration Server

🇬🇧 English | 🇹🇷 Türkçe

🇬🇧 English

An MCP server that enables LLM clients to perform standardized test case generation, quality control, Xray format conversion, and test suite composition.

🎯 Problem

Common issues in enterprise QA:

• Inconsistent test case formats: Different people write in different formats → not reusable

• No standard in Xray/Jira: Missing fields, unclear datasets, ambiguous steps

• Smoke/Regression distinction depends on individuals: Sprint-based planning is difficult

• When writing tests with LLM, same suggestions return or critical negative scenarios are missed

✨ Solution

QA-MCP provides:

• ✅ Single test standard: Everyone produces/improves with the same template

• ✅ Quality gate: Lint score + missing field detection

• ✅ Xray compatible output: Importable JSON

• ✅ Test suite/plan composition: Smoke/Regression/E2E suggestions + tagging

• ✅ Secure container deployment: Runnable from Docker Hub

📦 Installation

With uv (recommended)

# Install uv package manager
pip install uv

# Install qa-mcp
uv pip install qa-mcp

With pip

pip install qa-mcp
qa-mcp --help
qa-mcp --version

PyPI publishing rule:

• pip install qa-mcp becomes available after a successful Publish to PyPI workflow run.

• Manual publish: GitHub Actions -> Publish to PyPI -> Run workflow.

• Required GitHub secret: PYPI_API_TOKEN for pypi.org.

From source

git clone https://github.com/Atakan-Emre/McpTestGenerator.git
cd McpTestGenerator

# Using uv (recommended - uses locked dependencies)
uv pip install -e .

# Using pip
pip install -e .

With Docker

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

🚀 Usage

MCP Client Connection

Cursor / Claude Desktop

Add to your mcp.json or claude_desktop_config.json:

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

With Docker

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

🔧 Tools

📚 Resources

💬 Prompts

🐳 Docker

Published image: atakanemree/qa-mcp (multi-arch: linux/amd64, linux/arm64)

# Pull image
docker pull atakanemree/qa-mcp:latest

# Verify CLI
docker run --rm atakanemree/qa-mcp:latest --help

# Run (stdio mode - default, most secure)
docker run -i --rm atakanemree/qa-mcp:latest

# With environment variables
docker run -i --rm \
  -e LOG_LEVEL=debug \
  -e ENABLE_WRITE_TOOLS=false \
  atakanemree/qa-mcp:latest

# Local compose (production and dev targets)
docker compose up qa-mcp
docker compose --profile dev up qa-mcp-dev

🔒 Security

🗺️ Roadmap

• v1.0 - MVP: generate, lint, to_xray, compose

• v1.1 - Policy/guardrails, audit logs

• v1.2 - Jira/Xray sync (read-only)

• v2.0 - HTTP transport, OAuth

🇹🇷 Türkçe

LLM istemcilerinin bağlanıp standart test case üretme, kalite kontrol, Xray formatına çevirme ve test set kompozisyonu yapabildiği bir MCP sunucusu.

🎯 Problem

Kurumsal QA'da tipik sorunlar:

• Test case formatı dağınık: Farklı kişiler farklı biçimde yazar → tekrar kullanılamaz

• Xray/Jira'da standard yok: Alanlar eksik, dataset belirsiz, adımlar muğlak

• Smoke/Regression ayrımı kişiye bağlı: Sprint bazlı planlama zor

• LLM ile test yazdırınca aynı öneriler dönüyor veya kritik negatif senaryolar kaçıyor

✨ Çözüm

QA-MCP şunları sağlar:

• ✅ Tek test standardı: Herkes aynı şablonla üretir/iyileştirir

• ✅ Kalite kapısı (quality gate): Lint skoru + eksik alan tespiti

• ✅ Xray uyumlu çıktı: Import edilebilir JSON

• ✅ Test set/plan kompozisyonu: Smoke/Regression/E2E önerisi + etiketleme

• ✅ Güvenli container dağıtımı: Docker Hub'dan çalıştırılabilir

📦 Kurulum

uv ile (önerilen)

# uv paket yöneticisini kur
pip install uv

# qa-mcp'yi kur
uv pip install qa-mcp

pip ile

pip install qa-mcp
qa-mcp --help
qa-mcp --version

PyPI yayın kuralı:

• pip install qa-mcp, Publish to PyPI workflow'u başarılı tamamlandığında kullanılabilir olur.

• Manuel yayın: GitHub Actions -> Publish to PyPI -> Run workflow.

• Gerekli GitHub secret'ı: pypi.org için PYPI_API_TOKEN.

Kaynak koddan

git clone https://github.com/Atakan-Emre/McpTestGenerator.git
cd McpTestGenerator

# uv ile (önerilen - kilitli bağımlılıkları kullanır)
uv pip install -e .

# pip ile
pip install -e .

Docker ile

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

🚀 Kullanım

MCP İstemcisi ile Bağlantı

Cursor / Claude Desktop

mcp.json veya claude_desktop_config.json dosyasına ekleyin:

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

Docker ile

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

🔧 Tools

📚 Resources

💬 Prompts

🐳 Docker

Yayınlanan image: atakanemree/qa-mcp (multi-arch: linux/amd64, linux/arm64)

# Image çekme
docker pull atakanemree/qa-mcp:latest

# CLI doğrulama
docker run --rm atakanemree/qa-mcp:latest --help

# Çalıştırma (stdio mode - varsayılan, en güvenli)
docker run -i --rm atakanemree/qa-mcp:latest

# Environment variables ile
docker run -i --rm \
  -e LOG_LEVEL=debug \
  -e ENABLE_WRITE_TOOLS=false \
  atakanemree/qa-mcp:latest

# Local compose (production ve dev target'ları)
docker compose up qa-mcp
docker compose --profile dev up qa-mcp-dev

🔒 Güvenlik

🗺️ Yol Haritası

• v1.0 - MVP: generate, lint, to_xray, compose

• v1.1 - Policy/guardrails, audit logs

• v1.2 - Jira/Xray sync (read-only)

• v2.0 - HTTP transport, OAuth

📄 License / Lisans

MIT License - Copyright (c) 2024-2026 Atakan Emre

🤝 Contributing / Katkıda Bulunma

We welcome contributions! Please see our Contributing Guide for details on:

• 🚀 Setting up development environment

• 🧪 Running tests and quality checks

• 📝 Coding standards and best practices

• 🔄 Pull request process

Quick start:

1. Fork the repository / Fork yapın

2. Create feature branch / Feature branch oluşturun (git checkout -b feature/amazing-feature)

3. Make your changes / Değişiklikleri yapın

4. Run tests / Testleri çalıştırın (pytest tests/ -v)

5. Commit your changes / Commit yapın (git commit -m 'feat: add amazing feature')

6. Push to branch / Push yapın (git push origin feature/amazing-feature)

7. Open a Pull Request / Pull Request açın

👤 Developer / Geliştirici

Atakan Emre

• GitHub: @Atakan-Emre

• Repository: McpTestGenerator

Standardize test quality with QA-MCP! 🚀

QA-MCP ile test kalitesini standardize edin! 🚀