geropl/git-mcp-go

A Model Context Protocol (MCP) server for Git repository interaction and automation, written in Go. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.
## Features
This MCP server provides the following Git operations as tools:
gitstatus: Shows the working tree status
gitdiffunstaged: Shows changes in the working directory that are not yet staged
gitdiffstaged: Shows changes that are staged for commit
gitdiff: Shows differences between branches or commits
gitcommit: Records changes to the repository
gitadd: Adds file contents to the staging area
gitreset: Unstages all staged changes
gitlog: Shows the commit logs
gitcreatebranch: Creates a new branch from an optional base branch
gitcheckout: Switches branches
gitshow: Shows the contents of a commit
gitinit: Initialize a new Git repository
gitpush: Pushes local commits to a remote repository (requires --write-access flag)
gitlistrepositories: Lists all available Git repositories
## Installation
### Prerequisites
Go 1.18 or higher
Git installed on your system
### Download Prebuilt Binaries
You can download prebuilt binaries for your platform from the GitHub Releases page.
### Building from Source
bash
# Clone the repository
git clone https://github.com/geropl/git-mcp-go.git
cd git-mcp-go
# Build the server
go build -o git-mcp-go .
### Install with go install
bash
go install github.com/geropl/git-mcp-go@latest
## Usage
### Command Line Structure
The Git MCP Server uses a command-line structure with subcommands:
git-mcp-go
├── serve [flags] [repository-paths...]
│ ├── --repository, -r # Repository paths (multiple ways to specify)
│ ├── --mode
│ ├── --write-access
│ └── --verbose, -v
└── setup [flags] [repository-paths...]
├── --repository, -r # Repository paths (multiple ways to specify)
├── --mode
├── --write-access
├── --auto-approve
└── --tool
### Multi-Repository Support
The Git MCP Server can now monitor and operate on multiple repositories simultaneously. You can specify repositories in several ways:
1. Using the -r/--repository flag:
With comma-separated paths: -r=/path/to/repo1,/path/to/repo2
With multiple flag instances: -r=/path/to/repo1 -r=/path/to/repo2
2. As positional arguments: serve /path/to/repo1 /path/to/repo2
3. A combination of both approaches
When using multiple repositories, the server will default to the first repository for operations where a specific repository is not specified.
### serve Command
The serve command starts the Git MCP server:
bash
# Run with verbose logging
./git-mcp-go serve -v /path/to/repo1 /path/to/repo2 /path/to/repo3
# Run with go-git implementation
./git-mcp-go serve --mode go-git -r=/path/to/repo1,/path/to/repo2
# Enable write access for remote operations
./git-mcp-go serve -r=/path/to/repo1,/path/to/repo2 --write-access
The --mode flag allows you to choose between two different implementations:
shell: Uses the Git CLI commands via shell execution (default)
go-git: Uses the go-git library for Git operations where possible
The --write-access flag enables operations that modify remote state (currently only the push operation). By default, this is disabled for safety.
### setup Command
The setup command sets up the Git MCP server for use with an AI assistant. It copies itself to ~/mcp-servers/git-mcp-go and modifies the tools config (cline: clinemcpsettings.json) to use that binary.