Commit Reporter MCP

🧩 Local Git Weekly Report MCP

Lokal git depolarınızdan haftalık commit raporları oluşturan MCP servisi.

🚀 Kurulum

npm install

📋 Kullanım

MCP Server

npm start

CLI

# Haftalık rapor (basit çeviri - varsayılan)
node cli.js --type=weekly --dir=C:/projects --format=markdown

# AI ile akıllı çeviri
node cli.js --type=weekly --dir=C:/projects --format=markdown --ai

# Çeviri kapalı (orijinal mesajlar)
node cli.js --type=weekly --dir=C:/projects --no-translate

# Tarih aralığı
node cli.js --start=2025-11-01 --end=2025-11-11 --dir=C:/projects

# Gün bazlı
node cli.js --day=salı --dir=C:/projects/my-app

🎯 Özellikler

✅ Kullanıcı bazlı raporlama - Sadece kendi commit'leriniz ✅ Detaylı analiz - Değiştirilen dosyalar, satır sayıları ✅ Otomatik çeviri - Türkçe'ye çevrilmiş, anlaşılır raporlar ✅ AI desteği - OpenAI ile akıllı çeviri (opsiyonel) ✅ Haftalık rapor (Pazartesi-Cuma) ✅ Özel tarih aralığı ✅ Gün bazlı rapor ✅ Çoklu proje desteği ✅ JSON/Markdown/PDF çıktı ✅ Tamamen lokal çalışır

🛠️ MCP Araçları

• git_report_weekly - Bu haftanın raporu
• git_report_range - Tarih aralığı raporu
• git_report_day - Belirli gün raporu

Parametreler:

• translate (boolean) - Türkçe çeviri (varsayılan: true)
• useAI (boolean) - AI ile çeviri (varsayılan: false)

📄 Formatlar

• JSON: Programatik kullanım için
• Markdown: Döküman olarak paylaşım için
• PDF: Resmi raporlama için

🌍 Çeviri Özellikleri

Basit Çeviri (Varsayılan):

• Yaygın terimleri Türkçe'ye çevirir
• API gerekmez, hızlı çalışır
• Çoğu durumda yeterli

AI Çeviri (Opsiyonel):

• OpenAI GPT-4 ile akıllı çeviri
• Bağlam analizi ve detaylı açıklamalar
• OPENAI_API_KEY gerekli

Detaylar: CEVIRI_KULLANIM.md