git-context-mcp
A local Model Context Protocol (MCP) server that provides structured, high-signal insight into a Git repository, enabling AI coding agents to understand project state, structure, activity, and risk — without uploading or modifying the codebase.
Note
This README was generated usinggit-context-mcpitself, by connecting an AI assistant to the repository through the exposed MCP tools.
Problem This Project Solves
AI coding agents (Claude Code, Cursor, Codex, Gemini, etc.) are powerful, but they lack situational awareness when working with non-trivial codebases.
They often struggle to answer questions like:
- What is the current state of this project?
- Where are the real entry points?
- What parts of the code are actively changing?
- Which files are risky to touch?
git-context-mcp solves this by turning Git history and repository structure into explicit, machine-readable context that AI agents can consume before writing or reviewing code.
What This MCP Does (and Does Not)
What it does
- Runs locally as a standalone MCP process
- Reads only Git metadata and repository files
- Exposes read-only analysis tools
- Works over STDIO (compatible with MCP Inspector and desktop coding agents)
- Provides high-level context, not raw source dumps
