mcpField
G
git

git

Local
github.com/rog0xVersion Control0Updated 32w ago
Repository

About git

An MCP server for AI agents to inspect local Git repositories using native Git commands, without requiring the GitHub API. It provides history, diff, blame, activity statistics, and branch analysis.

Key features

  1. 01Filter commit history
  2. 02Compare refs with change summaries
  3. 03Inspect line-by-line authorship
  4. 04Review repository activity statistics
  5. 05Analyze branch status and divergence

Use cases

  1. 01Find commits by author, date, or path
  2. 02Summarize changes between branches
  3. 03Trace who changed a specific line
  4. 04Review contributors and frequently changed files

MCP support

Exposes local Git repository analysis tools to MCP clients, including log, diff, blame, statistics, and branch operations.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "rog0x-git": {
      "command": "npx",
      "args": [
        "-y",
        "@rog0x/mcp-git-tools"
      ]
    }
  }
}
Run commandnpx -y @rog0x/mcp-git-tools

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@rog0x/mcp-git-tools1.0.1

Tools

5

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
pathstringNoFilter commits that touched this file or directory path.
countnumberNoNumber of recent commits to return. Defaults to 20.
sincestringNoShow commits after this date (ISO 8601 or natural language).
untilstringNoShow commits before this date.
authorstringNoFilter commits by author name or email (substring match).
repoPathstringYesAbsolute path to the local Git repository.

Details

From the project README

mcp-git-tools

Git repository analysis tools for AI agents, served over MCP (Model Context Protocol). Analyzes local repositories using native git commands — no GitHub API required.

Tools

ToolDescription
git_logGet commit history with filtering by author, date range, and file path
git_diffShow diff between commits, branches, or tags with change summaries
git_blameShow who last modified each line of a file with commit info
git_statsRepository statistics: commits, contributors, activity over time, most changed files
git_branchList branches with last commit info, ahead/behind counts, merged/unmerged status

Prerequisites

  • Node.js >= 18
  • Git installed and available in PATH

Setup

npm install
npm run build

Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "git-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-git-tools/dist/index.js"]
    }
  }
}

Tool Details

git_log

Retrieve recent commit history with optional filters.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • count — Number of commits to return (default: 20)
  • author — Filter by author name or email
  • since / until — Date range filters
  • path — Filter to commits touching a specific file or directory
git_diff

Compare two refs and get a structured summary of changes.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • from — Start ref (default: HEAD~1)
  • to — End ref (default: HEAD)
  • path — Limit diff to a specific file or directory
  • summaryOnly — Return only stats without full diff text
git_blame

See line-by-line authorship of a file.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • filePath (required) — File path relative to repo root
  • startLine / endLine — Blame a specific line range
  • ref — Blame at a specific commit
git_stats

Get a high-level overview of repository activity.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • topAuthors — Number of top contributors to list (default: 10)
  • topFiles — Number of most-changed files to list (default: 10)
git_branch

List and analyze branches.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • baseBranch — Branch to compare against (default: main or master)
  • includeRemote — Include remote-tracking branches
  • mergedOnly / unmergedOnly — Filter by merge status

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.