QA-MCP

決定論的で構造化されたスケーラブルな品質保証（QA）のためのModel Context Protocol (MCP) サーバー。

🇬🇧 English | 🇹🇷 Türkçe

🇬🇧 English

📖 概要

QA-MCPは、アドホックなLLMプロンプトと構造化されたソフトウェアテストの間のギャップを埋めるものです。AIエージェントやMCPクライアントに対し、共通のテストケースモデル、厳格な品質分析、強力な正規化ユーティリティを提供します。

一貫性のない手動QAドキュメントとはお別れしましょう。QA-MCPを使用すれば、生の機能説明からテストケースを生成する場合でも、Gherkin構文を変換する場合でも、完全な回帰テストスイートを構成する場合でも、テスト成果物は標準化され、再利用可能であり、エンジニアリングチーム全体で完全に整合性が保たれます。

✨ 主な機能

• 🚀 標準化された生成: 機能説明や受け入れ基準から、高品質で構造化されたテストケースを自動生成します。

• 🛠️ スマートな正規化: Gherkin、Markdown、JSON、プレーンテキストを、標準的なQA-MCPスキーマにシームレスに変換します。

• 📈 高度なLintingとスコアリング: 共通の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（現在）: 標準スキーマ、生成、Linting、正規化、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.