QA-MCP

El servidor del Protocolo de Contexto de Modelo (MCP) para un Aseguramiento de Calidad determinista, estructurado y escalable.

🇬🇧 English | 🇹🇷 Türkçe

🇬🇧 English

📖 Descripción general

QA-MCP cierra la brecha entre los prompts ad-hoc de LLM y las pruebas de software estructuradas. Proporciona a los agentes de IA y a los clientes MCP un modelo de caso de prueba compartido, un análisis de calidad riguroso y potentes utilidades de normalización.

Olvídese de los documentos de QA manuales inconsistentes. QA-MCP garantiza que, ya sea que esté generando casos de prueba a partir de descripciones de funciones sin procesar, convirtiendo sintaxis Gherkin o componiendo suites de regresión completas, sus artefactos de prueba permanezcan estandarizados, reutilizables y perfectamente alineados en todos sus equipos de ingeniería.

✨ Características clave

• 🚀 Generación estandarizada: Genere automáticamente casos de prueba estructurados y de alta calidad a partir de descripciones de funciones y criterios de aceptación.

• 🛠️ Normalización inteligente: Convierta sin problemas Gherkin, Markdown, JSON y texto sin formato al esquema canónico de QA-MCP.

• 📈 Linting y puntuación avanzados: Evalúe los casos de prueba frente a un esquema de QA compartido con puntuaciones detalladas, seguimiento de problemas y orientación para mejoras.

• 🔗 Listo para Xray: Convierta instantáneamente casos de prueba estandarizados en cargas útiles JSON compatibles con Xray para la integración con Jira.

• 📦 Composición de suites: Componga y gestione dinámicamente suites de pruebas de Smoke, Sanity, Regresión y E2E.

• 📊 Informes de cobertura: Realice un seguimiento e informe de las métricas de cobertura en requisitos, módulos y áreas de riesgo.

🚀 Inicio rápido

Instalar vía PyPI

pip install qa-mcp
qa-mcp --version

Instalar vía uv

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

Ejecutar vía Docker

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

🔌 Conexión de un cliente MCP

Configure su cliente MCP preferido (por ejemplo, Claude Desktop) para usar QA-MCP.

Configuración estándar:

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

Configuración de Docker:

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

🛠️ Superficie pública de MCP

Herramientas

Recursos

Prompts

⚙️ Arquitectura y configuración

QA-MCP está diseñado para una ejecución segura y localizada:

• Transporte: Actualmente opera exclusivamente a través de entrada/salida estándar (stdio).

• Integraciones: La sincronización con capacidad de escritura directa (por ejemplo, API de Jira/Xray) y los oyentes de red están planificados para hitos futuros del roadmap. La funcionalidad actual de Xray se centra en la generación robusta de cargas útiles.

Variables de entorno:

🐳 Despliegue en Docker

La imagen oficial está disponible en 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

📚 Documentación

Para profundizar en la arquitectura y las pautas de contribución de QA-MCP, explore los documentos:

• USAGE.md: Ejemplos de uso detallados y cargas útiles de solicitud.

• CONTRIBUTING.md: Flujo de trabajo del colaborador y controles de calidad.

• CHANGELOG.md: Historial de versiones.

• docs/PUBLISHING.md: Flujo de publicación de paquetes y versiones.

🗺️ Roadmap

• Fase 1 (Actual): Esquema estándar, generación, linting, normalización, exportación de carga útil Xray y composición de suites a través de stdio.

• Fase 2 (A corto plazo): Lógica de normalización mejorada para entradas del mundo real desordenadas, bibliotecas de ejemplos ampliadas y una ergonomía de informes de cobertura más rica.

• Fase 3 (Planificado): Integraciones de solo lectura para sistemas de QA externos y puntos finales con capacidad de escritura estrictamente controlados y seguros.

📄 Licencia

Publicado bajo la Licencia MIT. Consulte LICENSE para obtener más detalles.

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