Skip to main content
Glama
luckdevx

mcp-git-chronicle

by luckdevx

mcp-git-chronicle

License: MIT

A zero-dependency Model Context Protocol (MCP) server providing deep Git archaeology, churn hotspot detection, and co-change coupling analysis to AI coding agents (OpenCode, Cursor, Claude Code).


Why mcp-git-chronicle?

AI coding agents make bad assumptions when editing code without knowing the repository's history:

  1. Volatile Code: They modify fragile files that historically cause high bug rates.

  2. Hidden Coupling: They edit a function or schema in File A, completely unaware that File B and File C always need matching changes.

  3. Missing Context: They fail to understand why a particular architecture decision was made 3 months ago.

mcp-git-chronicle connects your agents directly to local Git plumbing via standard MCP tools over stdio.


Related MCP server: architectos

Tools Exposed

Tool Name

Parameters

Description

git_churn_hotspots

cwd, since, limit

Identifies top files with highest churn (additions + deletions) and commit volume.

git_co_changes

file, cwd, limit

Calculates semantic file coupling (which files historically commit together with target).

git_recent_context

cwd, count, path

Summarizes recent commit subjects, hashes, and authors to anchor agent awareness.


Setup with Coding Agents

OpenCode / Cursor (~/.config/opencode/config.json or .cursor/mcp.json)

{
  "mcpServers": {
    "git-chronicle": {
      "command": "npx",
      "args": ["-y", "mcp-git-chronicle"]
    }
  }
}

Claude Code

claude mcp add git-chronicle npx mcp-git-chronicle

License

MIT © luckdevx

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Automatically extracts architectural decisions, patterns, and insights from Git commits to build a local, structured project memory. It exposes this living context to AI tools via MCP, allowing them to understand the historical reasoning and evolution behind your codebase.
    12 npm
    6
    MIT
  • F
    license
    Not graded
    quality
    A
    maintenance
    Analyzes repositories, explains architecture, calculates change impact, and enforces guardrails for AI Agents like Claude Code, Cursor, and Codex via MCP tools.
    -
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI coding agents to retrieve cited git-history explanations for files and tickets, compile a Team Engineering Contract from repository artifacts, and follow guided Understand/Build workflows over MCP stdio. It lets clients such as Grok, Claude Code, Codex, Kiro, and Cursor share the same tools for evidence-backed repository understanding.
    1
    1 npm
    Apache 2.0