mcp-git 0.2.0

MCP server that lets LLMs explore and search Git repositories
Documentation

mcp-git

MCP server that lets LLMs explore Git repositories — commit history, diffs, branches, and search. Single binary, read-only.

Install

cargo install mcp-git

Usage

# Current directory
mcp-git

# Specific repo
mcp-git --repo /path/to/repo

# Multiple repos
mcp-git --repo /path/to/repo1 --repo /path/to/repo2

# Custom limits
mcp-git --repo . --max-log-entries 100 --max-diff-lines 1000

Configuration

Claude Code

claude mcp add git -- mcp-git --repo /path/to/your/repo

Claude Desktop

{
  "mcpServers": {
    "git": {
      "command": "mcp-git",
      "args": ["--repo", "/path/to/your/repo"]
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "git": {
      "command": "mcp-git",
      "args": ["--repo", "/path/to/your/repo"]
    }
  }
}

Tools

Tool Description
list_repos Show all connected repositories with current branch
log Show commit history with author, date, and message
diff Show changes between two refs (commits, branches, tags)
show_commit Show details of a specific commit
list_branches List local and remote branches
search_commits Search commit messages for a query string

All tools accept an optional repo parameter when multiple repositories are connected.

CLI Options

Flag Default Description
--repo . Path to a Git repository (repeatable)
--max-diff-lines 500 Maximum diff output lines
--max-log-entries 50 Maximum log entries returned

License

Licensed under either of Apache License, Version 2.0 or MIT License at your option.