# Git Insights

> Git Insights is an open-source MCP server for developer tools. Read-only git history, blame ownership, churn and large-file stats for a local repository. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://basitalisandhu.github.io/dev-mcp-servers/
- **Repository:** https://github.com/basitalisandhu/dev-mcp-servers/tree/HEAD/packages/git-insights
- **MCP Registry name:** io.github.basitalisandhu/mcp-git-insights
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-14

## About

Git Insights answers questions about who touched what in a repository without modifying it. It can summarise a repo, list commits with filters, break one file's lines down by author, rank files by churn with lines added and removed, count commits per author and find the largest blobs in a tree or in all history.

Safety is a stated design point: each git command is spawned without a shell from a fixed argument list, with validated paths and revisions, a 20 second timeout and an output cap. Nothing is written, fetched or checked out, and no command that contacts a remote is allowed. Remote URLs in the summary have credentials stripped. The README notes that it does not restrict which repository paths can be read, so run it under an appropriate account.

It runs in a pinned Docker image with the repository mounted read-only at /repo, and requires git on the path inside it. MIT licensed.

## Features

- **Repository summary:** Branch, HEAD, remotes, counts and working tree status.
- **Filtered log:** Commits by author, date, path or message text.
- **Blame summary:** Lines and share per author for a file.
- **Churn ranking:** Files ranked by commits, following renames.
- **Author counts:** Commits per author with first and last dates.
- **Large file finder:** Finds the biggest blobs, including in history.

## Good for

- Find who owns most of a file before asking for a review
- Locate hot spots that change most often
- Work out which blobs make a clone large
- Summarise a quarter's contributors for a report

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-git-insights -- docker run -i --rm ghcr.io/basitalisandhu/mcp-git-insights:0.3.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-git-insights": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-git-insights:0.3.0"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-git-insights": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-git-insights:0.3.0"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-git-insights": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-git-insights:0.3.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-git-insights": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-git-insights:0.3.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-git-insights": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-git-insights:0.3.0"
      ]
    }
  }
}
```

## Tools

- `repo_summary`: Summarise a repository.
- `git_log`: List commits with filters.
- `blame_summary`: Per-author line share for a file.
- `churn`: Rank files by change frequency.
- `authors`: Commits per author.
- `large_files`: Find the largest blobs.

## FAQ

### Can it change my repository?

No. The README says nothing is written, fetched or checked out.

### Does it use the network?

No; no command that contacts a remote is on the allowlist.

### How do I mount my repo?

Mount it at /repo read-only in the Docker command.

### Is the log limited?

The git_log tool accepts a limit from 1 to 500.

### Is Git Insights free?

Yes. Git Insights is open source, so you can use and self-host it for free.

### How do I add Git Insights to Claude Code?

Run this command in your terminal: claude mcp add mcp-git-insights -- docker run -i --rm ghcr.io/basitalisandhu/mcp-git-insights:0.3.0

### What are the best alternatives to Git Insights?

The closest alternatives to Git Insights are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/git-insights
