Git周报生成工具

一个从本地Git仓库生成周度提交报告的工具,支持多格式输出和智能翻译功能。

  • by 07kagan07
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 07kagan07/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