QA-MCP

Der Model Context Protocol (MCP) Server für deterministische, strukturierte und skalierbare Qualitätssicherung.

🇬🇧 English | 🇹🇷 Türkçe

🇬🇧 Englisch

📖 Übersicht

QA-MCP schließt die Lücke zwischen Ad-hoc-LLM-Prompts und strukturiertem Softwaretest. Es bietet KI-Agenten und MCP-Clients ein gemeinsames Testfallmodell, eine rigorose Qualitätsanalyse und leistungsstarke Normalisierungs-Dienstprogramme.

Verabschieden Sie sich von inkonsistenten manuellen QA-Dokumenten. QA-MCP stellt sicher, dass Ihre Testartefakte standardisiert, wiederverwendbar und perfekt auf Ihre Engineering-Teams abgestimmt bleiben – egal, ob Sie Testfälle aus rohen Feature-Beschreibungen generieren, Gherkin-Syntax konvertieren oder vollständige Regressionssuiten zusammenstellen.

✨ Hauptmerkmale

• 🚀 Standardisierte Generierung: Automatische Generierung hochwertiger, strukturierter Testfälle aus Feature-Beschreibungen und Akzeptanzkriterien.

• 🛠️ Intelligente Normalisierung: Nahtlose Konvertierung von Gherkin, Markdown, JSON und Klartext in das kanonische QA-MCP-Schema.

• 📈 Erweitertes Linting & Scoring: Bewertung von Testfällen anhand eines gemeinsamen QA-Schemas mit detaillierten Bewertungen, Problemverfolgung und Verbesserungshinweisen.

• 🔗 Xray-bereit: Sofortige Konvertierung standardisierter Testfälle in Xray-kompatible JSON-Payloads für die Jira-Integration.

• 📦 Suiten-Zusammenstellung: Dynamische Erstellung und Verwaltung von Smoke-, Sanity-, Regressions- und E2E-Testsuiten.

• 📊 Abdeckungsberichte: Verfolgung und Berichterstattung von Abdeckungsmetriken über Anforderungen, Module und Risikobereiche hinweg.

🚀 Schnellstart

Installation via PyPI

pip install qa-mcp
qa-mcp --version

Installation via uv

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

Ausführung via Docker

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

🔌 Verbinden eines MCP-Clients

Konfigurieren Sie Ihren bevorzugten MCP-Client (z. B. Claude Desktop) für die Verwendung von QA-MCP.

Standardkonfiguration:

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

Docker-Konfiguration:

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

🛠️ Öffentliche MCP-Oberfläche

Tools

Ressourcen

Prompts

⚙️ Architektur & Konfiguration

QA-MCP ist für eine sichere, lokalisierte Ausführung konzipiert:

• Transport: Arbeitet derzeit ausschließlich über Standard-Input/Output (stdio).

• Integrationen: Synchronisation mit direkter Schreibfähigkeit (z. B. Jira/Xray-APIs) und Netzwerk-Listener sind für zukünftige Meilensteine geplant. Die aktuelle Xray-Funktionalität konzentriert sich auf eine robuste Payload-Generierung.

Umgebungsvariablen:

🐳 Docker-Bereitstellung

Das offizielle Image ist auf Docker Hub verfügbar: 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

📚 Dokumentation

Für tiefe Einblicke in die Architektur und die Mitwirkungsrichtlinien von QA-MCP, erkunden Sie die Dokumentation:

• USAGE.md: Detaillierte Nutzungsbeispiele und Request-Payloads.

• CONTRIBUTING.md: Workflow für Mitwirkende und Qualitätsprüfungen.

• CHANGELOG.md: Releasestory.

• docs/PUBLISHING.md: Veröffentlichungsablauf für Pakete und Releases.

🗺️ Roadmap

• Phase 1 (Aktuell): Standardschema, Generierung, Linting, Normalisierung, Xray-Payload-Export und Suiten-Zusammenstellung via stdio.

• Phase 2 (Kurzfristig): Verbesserte Normalisierungslogik für unsaubere reale Eingaben, erweiterte Beispielbibliotheken und reichhaltigere Ergonomie für Abdeckungsberichte.

• Phase 3 (Geplant): Read-only-Integrationen für externe QA-Systeme und streng kontrollierte, sichere Endpunkte mit Schreibzugriff.

📄 Lizenz

Veröffentlicht unter der MIT-Lizenz. Siehe LICENSE für Details.

🇹🇷 Türkçe

📖 Genel Bakış

QA-MCP, LLM istemleri (prompt) ile yapılandırılmış yazılım test süreçleri arasındaki köprüyü kurar. Yapay zeka ajanlarına ve MCP istemcilerine ortak bir test senaryosu modeli, titiz bir kalite analizi ve güçlü normalizasyon araçları sunar.

Tutarsız ve manuel hazırlanan QA dokümanlarına veda edin. QA-MCP; ham özellik tanımlarından test case üretirken, Gherkin sözdizimini dönüştürürken veya kapsamlı regresyon suitleri oluştururken test varlıklarınızın standart, yeniden kullanılabilir ve yazılım ekiplerinizle mükemmel bir uyum içinde kalmasını sağlar.

✨ Temel Özellikler

• 🚀 Standart Üretim: Feature metinlerinden ve kabul kriterlerinden otomatik olarak yüksek kaliteli, yapılandırılmış test case'ler üretin.

• 🛠️ Akıllı Normalizasyon: Gherkin, Markdown, JSON ve düz metinleri standart QA-MCP şemasına sorunsuz bir şekilde dönüştürün.

• 📈 Gelişmiş Linting ve Skorlama: Test senaryolarını ortak kalite şemasına göre değerlendirin; detaylı skorlar, hatalar ve iyileştirme adımları elde edin.

• 🔗 Xray Entegrasyonuna Hazır: Standart test case'leri anında Jira/Xray uyumlu JSON payload'larına dönüştürün.

• 📦 Suite Yönetimi: Smoke, Sanity, Regression ve E2E test suitlerini dinamik olarak oluşturun ve yönetin.

• 📊 Kapsam (Coverage) Raporlama: Gereksinim, modül ve risk bazlı test kapsam metriklerini raporlayın.

🚀 Hızlı Başlangıç

PyPI üzerinden kurulum

pip install qa-mcp
qa-mcp --version

uv ile kurulum

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

Docker ile çalıştırma

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

🔌 MCP İstemcisine Bağlanma

Tercih ettiğiniz MCP istemcisini (örn. Claude Desktop) QA-MCP kullanacak şekilde yapılandırın.

Standart Yapılandırma:

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

Docker Yapılandırması:

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

🛠️ Public MCP Yüzeyi

Tool'lar (Araçlar)

Resource'lar (Kaynaklar)

Prompt'lar

⚙️ Mimari ve Yapılandırma

QA-MCP, güvenli ve lokal çalışacak şekilde tasarlanmıştır:

• Bağlantı (Transport): Şu anda yalnızca standart girdi/çıktı (stdio) üzerinden çalışır.

• Entegrasyonlar: Doğrudan yazma yetkisine sahip API senkronizasyonları (örn. Jira/Xray'e direkt push) ve ağ dinleyicileri (network listeners) gelecek yol haritasında planlanmıştır. Mevcut Xray özelliği güçlü payload üretimine odaklanır.

Ortam Değişkenleri:

🐳 Docker Dağıtımı

Resmi imaj Docker Hub üzerinde yayındadır: 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

📚 Dokümantasyon

Mimari detaylar ve projeye katkı rehberleri için:

• USAGE.md: Detaylı kullanım örnekleri ve request payload'ları. |

• CONTRIBUTING.md: Katkı akışı ve kalite kontrolleri. |

• CHANGELOG.md: Sürüm ve değişiklik geçmişi. |

• docs/PUBLISHING.md: Paket ve release yayın süreci. |

🗺️ Yol Haritası

• Aşama 1 (Mevcut): stdio üzerinden standart şema, üretim, linting, normalizasyon, Xray export ve suite kompozisyonu.

• Aşama 2 (Kısa Vadeli): Dağınık girdiler için geliştirilmiş normalizasyon mantığı, daha zengin örnek kütüphaneleri ve iyileştirilmiş raporlama ergonomisi.

• Aşama 3 (Planlanan): Dış QA sistemleri için read-only entegrasyonlar ve kontrollü/güvenli write-capable uç noktalar.

📄 Lisans

MIT License ile yayınlanmıştır. Ayrıntılar için LICENSE dosyasına göz atabilirsiniz.