git-mcp

What is git-mcp?

git-mcp is a Model Context Protocol (MCP) server that interacts with Git repositories. It provides tools for executing Git operations, viewing commit history, tracking file changes, and examining file differences. It is designed for developers and AI assistants that need programmatic access to Git repository data.

How to use git-mcp?

Install the package with go install github.com/wricardo/git-mcp@latest. Then configure your MCP client settings with a WORKDIR environment variable pointing to a local Git repository. Finally, run git-mcp to start the server. The server exposes four tools: git-log, git-changed-files, git-file-diff, and git-file-history.

Key features of git-mcp

• Execute Git operations through MCP tools
• View commit history with hash, author, date, message
• List files changed between commits
• Show detailed file differences between commits
• Track commit history for a specific file

Use cases of git-mcp

• Exploring a Git repository’s commit history
• Reviewing file changes between recent commits
• Inspecting detailed diffs of a specific file
• Tracking changes to a file over time
• Enabling AI assistants to query Git data

FAQ from git-mcp

What are the system requirements for git-mcp?

Go 1.23.0 or later and Git must be installed on your system. You also need access to a Git repository.

How do I configure git-mcp?

Set the WORKDIR environment variable to the absolute path of your Git repository in your MCP client settings (e.g., "env": {"WORKDIR": "/path/to/repo"}).

What tools does git-mcp provide?

git-mcp provides four tools: git-log (commit history), git-changed-files (files changed between HEAD and a given number of commits back), git-file-diff (detailed file differences between commits), and git-file-history (commit history for a specific file).

Can I limit the number of commits displayed?

Yes, the git-log and git-file-history tools accept an optional limit parameter (default 10).