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.
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 pip
From source
With Docker
🚀 Usage
MCP Client Connection
Cursor / Claude Desktop
Add to your mcp.json or claude_desktop_config.json:
With Docker
🔧 Tools
Tool | Description |
| Generate standardized test cases from feature & acceptance criteria |
| Analyze test case quality, return score and improvement suggestions |
| Convert Gherkin/Markdown → Standard format |
| Export to Xray/Jira import format |
| Create Smoke/Regression/E2E test suites |
| Generate test coverage analysis |
📚 Resources
URI | Description |
| Test case standard |
| Lint rules |
| Xray field mapping |
| Good test case examples |
| Bad test case examples |
💬 Prompts
Prompt | Description |
| Create Xray Manual Test |
| Smoke test selection |
| Generate negative scenarios |
| Test coverage analysis |
🐳 Docker
🔒 Security
Variable | Default | Description |
|
| Enables Jira/Xray write tools |
|
| Log level (
,
,
,
) |
|
| Enables audit logging |
|
| Enables HTTP transport |
|
| 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
pip ile
Kaynak koddan
Docker ile
🚀 Kullanım
MCP İstemcisi ile Bağlantı
Cursor / Claude Desktop
mcp.json veya claude_desktop_config.json dosyasına ekleyin:
Docker ile
🔧 Tools
Tool | Açıklama |
| Feature ve acceptance criteria'dan standart test case üretir |
| Test case kalitesini analiz eder, skor ve öneriler döner |
| Gherkin/Markdown → Standart format dönüşümü |
| Xray/Jira import formatına çevirir |
| Smoke/Regression/E2E test suite oluşturur |
| Test kapsam analizi raporu üretir |
📚 Resources
URI | Açıklama |
| Test case standardı |
| Lint kuralları |
| Xray alan eşlemesi |
| İyi test case örnekleri |
| Kötü test case örnekleri |
💬 Prompts
Prompt | Açıklama |
| Xray Manual Test oluşturma |
| Smoke test seçimi |
| Negatif senaryo üretimi |
| Test kapsam analizi |
🐳 Docker
🔒 Güvenlik
Değişken | Varsayılan | Açıklama |
|
| Jira/Xray yazma tool'larını etkinleştirir |
|
| Log seviyesi (
,
,
,
) |
|
| Audit log'u etkinleştirir |
|
| HTTP transport'u etkinleştirir |
|
| 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
MIT License - Copyright (c) 2024-2026 Atakan Emre
🤝 Contributing / Katkıda Bulunma
Fork the repository / Fork yapın
Create feature branch / Feature branch oluşturun (
git checkout -b feature/amazing-feature)Commit your changes / Commit yapın (
git commit -m '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! 🚀