Skip to main content
Glama
deenesjakoruzh
mrosano1987

git-daily-review

by mrosano1987
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

🔍 Git Daily Review

모든 Git 저장소를 위한 자동 일일 AI 코드 리뷰 — CLI, 예약 실행, 또는 AI 에이전트용 MCP 서버로 사용할 수 있습니다.

Git Daily Review는 여러 저장소의 일일 커밋을 분석하고, 프로젝트의 컨벤션과 품질 게이트에 따라 검사한 후 구조화된 Markdown 보고서를 생성합니다. MCP(Model Context Protocol) 서버가 포함되어 있어 Claude Code 및 Claude Desktop과 같은 에이전트가 대화형으로 리뷰를 실행하고, 보고서를 읽고, 프로젝트 지식 베이스를 관리할 수 있습니다.

라이선스: AGPL-3.0-only · Python 3.10+ 코어 · TypeScript MCP 서버

주요 기능

  • 모든 저장소, 모든 언어 — AI가 사용자의 스택(TypeScript, Python, Java, Go, Rust, C#, …)에 적응합니다

  • 멀티 저장소 — 단일 실행으로 필요한 만큼 많은 저장소를 모니터링합니다

  • MCP 서버 — 리뷰, 보고서, 지식 베이스 관리를 에이전트 도구로 노출합니다

  • 멀티 프로바이더 AI — Anthropic Claude, OpenAI, Google Gemini, 또는 Ollama를 통한 모든 로컬 모델(완전 오프라인)

  • 자기 개선 지식 베이스 — 각 리뷰에서 학습하는 7계층 프로젝트 컨텍스트, 코드로 강제되는 자동 병합 정책과 영향이 큰 변경에 대한 인간 승인

  • Markdown + HTML 출력 — 모든 실행은 daily-summary.md와 자체 포함형 dashboard.html(품질 추세, 게이트 및 작성자별 차트, 필터 가능한 커밋 목록, 모든 차트 뒤의 테이블 뷰)을 생성합니다. CDN 없음, 네트워크 호출 없음: 코드 리뷰 데이터가 머신을 벗어나지 않습니다

  • RAG 지원 — 의미적 컨텍스트를 위한 외부 RAG 서비스와의 선택적 통합

  • 크로스 플랫폼 스케줄링 — macOS(launchd), Linux(cron), Windows(작업 스케줄러); 비밀값은 .env에 유지되며 스케줄러 파일에는 절대 저장되지 않습니다

  • 설정 마법사 — 웹 기반 구성, 수동 YAML 편집 불필요

Related MCP server: MatterAI MCP Server

빠른 시작 (CLI)

git clone https://github.com/YOUR_USER/git-daily-review.git
cd git-daily-review

# 0. Dependencies in a virtualenv (setup.py does this for you if you skip it)
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

# 1. Configure (opens the wizard in your browser)
python3 setup.py

# 2. Secrets (cloud providers only — Ollama needs none)
cp .env.example .env      # then add e.g. ANTHROPIC_API_KEY=...
chmod 600 .env

# 3. First review
python3 scripts/daily_review.py

# 4. Schedule daily runs
python3 scripts/scheduler.py --install

CLI 참조:

python3 scripts/daily_review.py                    # review today
python3 scripts/daily_review.py --date 2026-05-12  # specific date
python3 scripts/daily_review.py --days 5           # last N days
python3 scripts/daily_review.py --collect-only     # git data only, no AI
python3 scripts/daily_review.py --history          # report history index

python3 scripts/kb_manager.py --review             # interactive KB curation
python3 scripts/kb_manager.py --approve <ID>       # non-interactive approve
python3 scripts/kb_manager.py --reject  <ID>       # non-interactive reject
python3 scripts/kb_manager.py --stats

위의 python3은 모든 인터프리터가 될 수 있습니다: 의존성이 없는 경우 엔트리 포인트는 프로젝트 .venv(또는 $GDR_PYTHON)에서 스스로 재실행되며, 없으면 생성 방법을 안내합니다. 이는 python3이 종종 순수 시스템 Python인 cron과 launchd에서 중요합니다.

MCP 서버 (에이전트로 사용)

mcp/ 디렉토리에는 리뷰 엔진을 래핑하는 TypeScript MCP 서버가 포함되어 있습니다.

cd mcp
npm install
npm run build

Claude Code에 등록:

claude mcp add git-daily-review -- node /absolute/path/to/git-daily-review/mcp/dist/index.js

또는 Claude Desktop(claude_desktop_config.json)에 추가:

{
  "mcpServers": {
    "git-daily-review": {
      "command": "node",
      "args": ["/absolute/path/to/git-daily-review/mcp/dist/index.js"]
    }
  }
}

노출된 도구:

도구

기능

run_daily_review

오늘, 특정 날짜 또는 최근 N일 동안의 리뷰 실행

get_report

특정 날짜의 전체 Markdown 보고서 읽기

list_reports

사용 가능한 보고서 + 기록 인덱스 나열

list_kb_suggestions

KB 제안 나열(상태별 필터)

decide_kb_suggestion

ID로 대기 중인 제안 승인/거부

kb_stats

지식 베이스 통계

그런 다음 에이전트에게 "오늘 리뷰를 실행하고 중요 이슈를 요약해 줘" 또는 "대기 중인 KB 제안을 보여주고 명명 규칙에 관한 것을 승인해 줘" 같은 요청을 하면 됩니다.

환경 변수 오버라이드: GDR_ROOT(프로젝트 루트, 기본값: 저장소 루트), GDR_PYTHON(Python 실행 파일; 기본값: 프로젝트 .venv가 있으면 그것, 없으면 python3).

AI 프로바이더

프로바이더

모델

API 키 환경 변수

참고

Anthropic

Claude Haiku, Sonnet, Opus

ANTHROPIC_API_KEY

OpenAI

GPT-4o-mini, GPT-4o, o1-mini

OPENAI_API_KEY

Google Gemini

Gemini 2.0 Flash, 1.5 Flash/Pro

GEMINI_API_KEY

Ollama(로컬)

모든 풀(pull)된 모델

(없음)

완전 오프라인; 프롬프트 잘림을 방지하려면 config에서 num_ctx 설정(기본값 32768)

비밀값은 프로젝트 루트의 .env 파일(.env.example 참조)에 있으며 시작 시 자동으로 로드됩니다. 비밀값은 launchd plist, crontab 또는 배치 파일에 절대 기록되지 않습니다.

지식 베이스 (7계층)

config/knowledge-base.yaml은 리뷰어에게 구조화된 프로젝트 컨텍스트를 제공합니다:

L0 Identity · L1 Architecture · L2 Conventions · L3 Quality Gates
L4 Domain · L5 Integrations · L6 Release

각 실행 후 시스템은 리뷰에서 드러난 새 지식을 추출하여 config/kb_suggestions/에 제안으로 저장합니다. 자동 병합 정책은 (모델이 아닌) 코드로 강제됩니다: 신뢰도 ≥ 0.85인 새 컨벤션과 info/warning 게이트만 자동 병합할 수 있으며, 실행당 최대 2개로 제한됩니다. 중요 게이트, 도메인 규칙 및 통합은 항상 인간 승인이 필요합니다 — 대화형(kb_manager.py --review), CLI 플래그, 또는 MCP decide_kb_suggestion 도구를 통해.

config.yaml의 ai: 섹션에서 kb_learning: false로 학습을 완전히 비활성화할 수 있습니다.

프로젝트 구조

git-daily-review/
├── setup.py                    ← setup wizard entry point
├── requirements.txt
├── .env.example                ← secrets template (never commit .env)
├── config/
│   ├── config.example.yaml
│   └── knowledge-base.example.yaml
├── scripts/                    ← Python core
│   ├── daily_review.py         ← orchestrator (loads .env at startup)
│   ├── git_collector.py        ← fetch, commits, diffs
│   ├── ai_reviewer.py          ← review pipeline
│   ├── ai_provider.py          ← Anthropic/OpenAI/Ollama/Gemini abstraction
│   ├── kb_updater.py           ← KB learning + code-enforced auto-merge policy
│   ├── kb_manager.py           ← KB curation CLI (interactive + --approve/--reject)
│   ├── rag_client.py           ← optional RAG client
│   ├── report_generator.py     ← Markdown reports + history index
│   ├── html_report.py          ← self-contained HTML dashboard (charts, filters)
│   ├── scheduler.py            ← launchd / cron / schtasks (no secrets on disk)
│   └── wizard_app.py           ← wizard HTTP backend
├── mcp/                        ← MCP server (TypeScript)
│   └── src/index.ts
├── templates/wizard.html
└── reports/                    ← generated daily reports (git-ignored)

로드맵

  • 일일 보고서에 대한 Slack/이메일 알림

  • --ci 모드: 중요 발견 시 0이 아닌 종료 코드(PR 게이팅)

  • 코어의 전체 TypeScript 포팅

  • 원격 저장소 지원(로컬 클론 없이 리뷰)

기여를 환영합니다 — 이슈 또는 PR을 열어 주세요.

라이선스

이 프로젝트는 GNU Affero General Public License v3.0(AGPL-3.0-only)에 따라 라이선스가 부여됩니다. 수정된 버전을 네트워크 서비스로 실행하는 경우 해당 서비스 사용자에게 소스 코드를 제공해야 합니다. LICENSE를 참조하세요.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mrosano1987/git-daily-review'

If you have feedback or need assistance with the MCP directory API, please join our Discord server