🔍 gitlog-mcp

AI 코딩 에이전트에 git 기록에 대한 초능력을 부여하세요.

gitlog-mcp는 Model Context Protocol (MCP) 서버로, AI 에이전트(Claude Code, Cursor, Windsurf 및 모든 MCP 클라이언트)가 리포지토리에서 변경된 내용을 이해할 수 있게 해줍니다. — 자동으로 체인지로그 생성, 커밋 분석, 비난(blame) 추적, 릴리스 노트 작성.

"이 리포지토리에서 무엇이 변경되었나요?"는 모든 AI 에이전트가 틀리는 질문입니다. 이 도구가 해결합니다.

존재 이유

AI 코딩 에이전트는 코드 작성에는 뛰어나지만 코드베이스의 기록을 아는 데는 유명할 정도로 취약합니다. 체인지로그를 환각(hallucinate)하고, 비난(blame)을 잘못 추정하며, 릴리스 노트를 추측합니다. gitlog-mcp는 이들에게 git log에 대한 신뢰할 수 있고 구조화된 창을 제공하여, 답변이 허구가 아닌 실제 발생한 내용에 기반하도록 합니다.

Related MCP server: Continuum

기능

• 📝 자동 체인지로그 — 모든 태그/커밋 범위에서 깔끔하고 그룹화된 체인지로그 생성

• 🔎 커밋 분석 — 변경된 내용뿐 아니라 왜 변경이 발생했는지 설명

• 👤 비난(blame) 추적 — 누가 무엇을, 언제 수정했는지 (컨텍스트 포함)

• 🏷️ 릴리스 노트 — 태그 간 차이에서 릴리스 노트 초안 작성

• 📊 리포지토리 건강 — 커밋 빈도, 주요 기여자, 변경 핫스팟

• 🧱 런타임 의존성 제로 — 순수 Python 표준 라이브러리 + MCP SDK, 단일 파일

빠른 시작

# 1. Install from PyPI
pip install gitlog-mcp

# 2. Run standalone (for testing) — defaults to the current directory
gitlog-mcp
gitlog-mcp --repo /path/to/your/repo

# 3. Or add directly to your agent's MCP config (see below)

로컬 웹 대시보드도 원하시나요? 선택적 추가 기능이며 기본 설치에 포함되지 않습니다: pip install "gitlog-mcp[ui]". 일반 pip install gitlog-mcp는 그대로 의존성 제로를 유지합니다.

소스에서 설치(기여자용): git clone https://github.com/ManiaSacha/gitlog-mcp.git && cd gitlog-mcp && pip install -e . — 자세한 내용은 CONTRIBUTING.md를 참조하세요.

Claude Code 설정

{
  "mcpServers": {
    "gitlog": {
      "command": "gitlog-mcp",
      "args": ["--repo", "."]
    }
  }
}

Cursor 설정 (.cursor/mcp.json)

{
  "mcpServers": {
    "gitlog": {
      "command": "gitlog-mcp",
      "args": ["--repo", "."]
    }
  }
}

Windsurf 설정

{
  "mcpServers": {
    "gitlog": {
      "command": "gitlog-mcp",
      "args": ["--repo", "."]
    }
  }
}

독립 실행형 디버깅

에이전트를 연결하기 전에 도구를 직접 사용해보고 싶으신가요? MCP Inspector는 각 도구를 수동으로 호출할 수 있는 UI를 제공합니다:

npx @modelcontextprotocol/inspector gitlog-mcp --repo .

예시 에이전트 프롬프트

"v1.2.0과 v1.3.0 사이의 모든 변경사항에 대한 체인지로그를 생성해줘."

"누가 src/parser.py의 이 버그 있는 줄을 도입했고 왜 그랬지?"

"최근 커밋을 기반으로 다음 버전의 릴리스 노트 초안을 작성해줘."

노출된 도구

웹 대시보드 (선택 사항)

터미널보다 브라우저를 선호하시나요? gitlog-mcp-ui는 MCP 도구가 사용하는 동일한 git 읽기 코드 위에 작은 로컬 대시보드를 제공합니다 — 동일한 데이터, 사람이 읽을 수 있는 형식.

pip install "gitlog-mcp[ui]"
gitlog-mcp-ui --repo /path/to/repo

이 명령은 URL(http://127.0.0.1:8765 기본값)을 출력합니다 — 브라우저에서 열면 됩니다; 자동으로 열리지 않습니다.

읽기 전용 — 어디에도 쓰기 작업이 없습니다. 설계 상 로컬 전용: 127.0.0.1에만 바인딩되며(--host 플래그가 없어 우발적으로도 네트워크에 노출될 수 없음), 모든 요청의 Host 헤더도 검증하여 루프백 바인드만으로는 막을 수 없는 DNS-리바인딩 갭을 닫습니다. 인증이 필요하지 않습니다. 자신의 기기만 접근할 수 있기 때문입니다.

선택적 추가 기능(pip install gitlog-mcp[ui])이며 기본 설치에 포함되지 않습니다. 핵심 gitlog-mcp 서버는 MCP SDK 외에 런타임 의존성이 전혀 없습니다. 대시보드는 이를 변경하지 않습니다. 표준 라이브러리의 http.server를 사용하며, 프레임워크나 추가 의존성이 없습니다.

아키텍처

gitlog-mcp (single file, ~300 lines)
├── FastMCP server (stdio transport)
├── GitRunner — thin wrapper over `git` CLI
└── Tools — each maps to a git subcommand + parsing

의도적으로 작습니다. 오후에 전체를 읽을 수 있습니다 — 그것이 기능입니다.

기여하기

PR 환영합니다. 작고 집중적이며 잘 테스트된 변경만 부탁드립니다. CONTRIBUTING.md 참조.

릴리스 프로세스와 버전 관리에 대한 내용은 RELEASING.md에 문서화되어 있습니다.

로드맵

• --repo 현재 작업 디렉토리에서 자동 감지

• 모든 도구에 대한 구조화된 JSON 출력

• GitHub/GitLab 원격 통합

• 테스트 + CI 배지

라이선스

MIT © 2026 — 오픈 소스 커뮤니티를 위해 공개적으로 구축되었습니다.

AI 에이전트가 체인지로그를 환각하지 못하게 하려면 이 리포지토리에 별표를 눌러주세요. ⭐