QA-MCP

Сервер протокола Model Context Protocol (MCP) для детерминированного, структурированного и масштабируемого обеспечения качества (QA).

🇬🇧 English | 🇹🇷 Türkçe

🇬🇧 English

📖 Обзор

QA-MCP устраняет разрыв между ситуативными промптами LLM и структурированным тестированием ПО. Он предоставляет AI-агентам и MCP-клиентам общую модель тест-кейсов, строгий анализ качества и мощные инструменты нормализации.

Забудьте о несогласованных документах QA. QA-MCP гарантирует, что независимо от того, генерируете ли вы тест-кейсы из описаний функций, преобразуете синтаксис Gherkin или составляете полные наборы регрессионного тестирования, ваши тестовые артефакты остаются стандартизированными, пригодными для повторного использования и идеально согласованными между инженерными командами.

✨ Ключевые особенности

• 🚀 Стандартизированная генерация: Автоматическая генерация высококачественных структурированных тест-кейсов на основе описаний функций и критериев приемки.

• 🛠️ Умная нормализация: Бесшовная конвертация Gherkin, Markdown, JSON и обычного текста в каноническую схему QA-MCP.

• 📈 Продвинутый линтинг и оценка: Оценка тест-кейсов по общей схеме QA с подробными баллами, отслеживанием проблем и рекомендациями по улучшению.

• 🔗 Готовность к Xray: Мгновенное преобразование стандартизированных тест-кейсов в JSON-полезные нагрузки, совместимые с Xray для интеграции с Jira.

• 📦 Составление наборов тестов: Динамическое создание и управление наборами Smoke, Sanity, Regression и 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

# 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: Процесс публикации пакетов и релизов.

🗺️ Дорожная карта

• Фаза 1 (Текущая): Стандартная схема, генерация, линтинг, нормализация, экспорт полезной нагрузки Xray и составление наборов через stdio.

• Фаза 2 (Ближайшая): Улучшенная логика нормализации для «грязных» реальных входных данных, расширенные библиотеки примеров и более эргономичная отчетность по покрытию.

• Фаза 3 (Запланированная): Интеграции только для чтения с внешними системами QA и строго ограниченные, безопасные конечные точки с возможностью записи.

📄 Лицензия

Выпущено под лицензией MIT. Подробности см. в LICENSE.

🇹🇷 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.