What can you do with this server?

QA-MCP is a test standardization and orchestration server that enables LLM clients to generate, analyze, normalize, and manage test cases with quality control and Xray/Jira integration. Test Case Generation & Management: Generate standardized test cases from feature descriptions and acceptance criteria with configurable risk levels, boundary tests, and negative scenarios. Normalize test cases from various formats (Gherkin, Markdown, JSON, plain text) into QA-MCP standard format. Quality Analysis & Linting: Analyze test case quality with lint scoring and improvement suggestions in single or batch mode, with configurable strict mode for quality gates. Xray/Jira Integration: Convert test cases to Xray import-ready JSON format (Manual/Automated/Generic types) with support for custom field mappings, batch processing, and project key mapping. Access Xray mapping templates for field configuration. Test Suite Orchestration: Compose targeted test suites (Smoke, Sanity, Regression, E2E) from test case collections with sprint association and duration-based filtering. Coverage & Reporting: Generate coverage reports analyzing test coverage across modules and requirements. Additional Features: Access predefined resources including test case standards, lint rules, Xray field mappings, and example test cases. Use pre-defined prompts for common QA tasks. Deploy securely via Docker with configurable settings including audit logging, write tool controls, and HTTP transport.

Which integrations are available for this server?

Enables standardized test case generation and export to Jira/Xray format, with planned read-only sync capabilities for test management and import/export of test cases in Xray-compatible JSON format.

How do I use QA-MCP: Test Standardization & Orchestration Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@QA-MCP: Test Standardization & Orchestration Server generate test cases for user login with email and password" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

QA-MCP: Test Standardization & Orchestration Server

PyPI version Python License MCP Docker

🇬🇧 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

Tool	Description
`testcase.generate`	Generate standardized test cases from feature & acceptance criteria
`testcase.lint`	Analyze test case quality, return score and improvement suggestions
`testcase.normalize`	Convert Gherkin/Markdown → Standard format
`testcase.to_xray`	Export to Xray/Jira import format
`suite.compose`	Create Smoke/Regression/E2E test suites
`suite.coverage_report`	Generate test coverage analysis

📚 Resources

URI	Description
`qa://standards/testcase/v1`	Test case standard
`qa://checklists/lint-rules/v1`	Lint rules
`qa://mappings/xray/v1`	Xray field mapping
`qa://examples/good/*`	Good test case examples
`qa://examples/bad/*`	Bad test case examples

💬 Prompts

Prompt	Description
`create-manual-test`	Create Xray Manual Test
`select-smoke-tests`	Smoke test selection
`generate-negative-scenarios`	Generate negative scenarios
`review-test-coverage`	Test coverage analysis

🐳 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

Variable	Default	Description
`ENABLE_WRITE_TOOLS`	`false`	Enables Jira/Xray write tools
`LOG_LEVEL`	`info`	Log level (`debug`, `info`, `warning`, `error`)
`AUDIT_LOG_ENABLED`	`true`	Enables audit logging
`HTTP_ENABLED`	`false`	Enables HTTP transport
`HTTP_PORT`	`8080`	HTTP port

🗺️ 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

Tool	Açıklama
`testcase.generate`	Feature ve acceptance criteria'dan standart test case üretir
`testcase.lint`	Test case kalitesini analiz eder, skor ve öneriler döner
`testcase.normalize`	Gherkin/Markdown → Standart format dönüşümü
`testcase.to_xray`	Xray/Jira import formatına çevirir
`suite.compose`	Smoke/Regression/E2E test suite oluşturur
`suite.coverage_report`	Test kapsam analizi raporu üretir

📚 Resources

URI	Açıklama
`qa://standards/testcase/v1`	Test case standardı
`qa://checklists/lint-rules/v1`	Lint kuralları
`qa://mappings/xray/v1`	Xray alan eşlemesi
`qa://examples/good/*`	İyi test case örnekleri
`qa://examples/bad/*`	Kötü test case örnekleri

💬 Prompts

Prompt	Açıklama
`create-manual-test`	Xray Manual Test oluşturma
`select-smoke-tests`	Smoke test seçimi
`generate-negative-scenarios`	Negatif senaryo üretimi
`review-test-coverage`	Test kapsam analizi

🐳 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

Değişken	Varsayılan	Açıklama
`ENABLE_WRITE_TOOLS`	`false`	Jira/Xray yazma tool'larını etkinleştirir
`LOG_LEVEL`	`info`	Log seviyesi (`debug`, `info`, `warning`, `error`)
`AUDIT_LOG_ENABLED`	`true`	Audit log'u etkinleştirir
`HTTP_ENABLED`	`false`	HTTP transport'u etkinleştirir
`HTTP_PORT`	`8080`	HTTP port

🗺️ 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

🤝 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:

Fork the repository / Fork yapın
Create feature branch / Feature branch oluşturun (git checkout -b feature/amazing-feature)
Make your changes / Değişiklikleri yapın
Run tests / Testleri çalıştırın (pytest tests/ -v)
Commit your changes / Commit yapın (git commit -m 'feat: add amazing feature')
Push to branch / Push yapın (git push origin feature/amazing-feature)
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! 🚀

GitHub Stars GitHub Forks

QA-MCP: Test Standardization & Orchestration Server

🇬🇧 English

🎯 Problem

✨ Solution

📦 Installation

With uv (recommended)

With pip

From source

With Docker

🚀 Usage

MCP Client Connection

Cursor / Claude Desktop

With Docker

🔧 Tools

📚 Resources

💬 Prompts

🐳 Docker

🔒 Security

🗺️ Roadmap

🇹🇷 Türkçe

🎯 Problem

✨ Çözüm

📦 Kurulum

uv ile (önerilen)

pip ile

Kaynak koddan

Docker ile

🚀 Kullanım

MCP İstemcisi ile Bağlantı

Cursor / Claude Desktop

Docker ile

🔧 Tools

📚 Resources

💬 Prompts

🐳 Docker

🔒 Güvenlik

🗺️ Yol Haritası

📄 License / Lisans

🤝 Contributing / Katkıda Bulunma

👤 Developer / Geliştirici

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API