QA-MCP

결정론적이고 구조화된 확장 가능한 품질 보증(QA)을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다.

🇬🇧 English | 🇹🇷 Türkçe

🇬🇧 English

📖 개요

QA-MCP는 임시 LLM 프롬프트와 구조화된 소프트웨어 테스트 사이의 간극을 메워줍니다. AI 에이전트와 MCP 클라이언트에게 공유 테스트 케이스 모델, 엄격한 품질 분석 및 강력한 정규화 유틸리티를 제공합니다.

일관성 없는 수동 QA 문서와 작별하세요. QA-MCP는 원시 기능 설명에서 테스트 케이스를 생성하든, Gherkin 구문을 변환하든, 전체 회귀 테스트 스위트를 구성하든 관계없이 테스트 아티팩트가 표준화되고 재사용 가능하며 엔지니어링 팀 전체에서 완벽하게 정렬되도록 보장합니다.

✨ 주요 기능

• 🚀 표준화된 생성: 기능 설명 및 수락 기준으로부터 고품질의 구조화된 테스트 케이스를 자동으로 생성합니다.

• 🛠️ 스마트 정규화: Gherkin, Markdown, JSON 및 일반 텍스트를 표준 QA-MCP 스키마로 원활하게 변환합니다.

• 📈 고급 린팅 및 점수 산정: 상세 점수, 이슈 추적 및 개선 지침과 함께 공유 QA 스키마를 기준으로 테스트 케이스를 평가합니다.

• 🔗 Xray 준비 완료: 표준화된 테스트 케이스를 Jira 통합을 위한 Xray 호환 JSON 페이로드로 즉시 변환합니다.

• 📦 스위트 구성: 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)을 통해서만 작동합니다.

• 통합: 직접 쓰기 가능한 동기화(예: Jira/Xray API) 및 네트워크 리스너는 향후 로드맵 마일스톤으로 계획되어 있습니다. 현재 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.