Git MCP Server

A Git server based on the Model Context Protocol that provides a standardized Git repository management interface for AI assistants and LLM agents

Version control Developer tools #Git Service #AI Collaboration #Version Control #MCP Protocol .TypeScript

rating : 2.5 points

downloads : 6.9K

update time : 2025-04-29

Open Site

What is the GIT MCP Server?

The GIT MCP Server is a tool that provides Git repository management and operations. It implements a standardized interface through the Model Context Protocol (MCP). Users can perform common Git operations through this server without directly accessing the file system or command line.

How to Use the GIT MCP Server?

Users can install the server and integrate it into MCP-supported clients, such as Claude or other AI assistants. It can be used after simple configuration.

Applicable Scenarios

Suitable for developers, teams, and automation tools that need to manage Git repositories through standard interfaces.

Main Features

Repository Management

Initialize new repositories, clone remote repositories, and check repository status.

Branch Operations

Create, delete, merge branches, and switch branches.

Working Directory Operations

Add, commit, roll back changes, and generate differences.

Remote Repository Operations

Add, list, pull, and push remote repositories.

Advanced Operations

Advanced Git commands such as tagging, stashing, reverting, and resetting.

Advantages

Operate Git without directly accessing the file system or command line.

Support multiple Git operations to cover common needs.

Easy to integrate with other MCP-compatible tools.

Provide a standardized interface for easy expansion and maintenance.

Limitations

Require the installation of Node.js and Git environments.

May not support some complex custom Git operations.

Have a certain dependence on the network environment.

How to Use

Install the Server

Install the server globally via NPM or build it from the source code.

Start the Server

Run the server to listen for MCP requests.

Configure the Client

Add the server configuration to the MCP-supported client.

Usage Examples

Clone a Remote Repository

Clone a remote Git repository through the GIT MCP Server.

Commit Changes

Commit local changes to the Git repository.

Frequently Asked Questions

How to install the GIT MCP Server?

Does the server support custom Git commands?

Does the server support multi-user operations?

Related Resources

Official Documentation of the GIT MCP Server

Detailed installation and usage guides.

Official Website of the Model Context Protocol

Understand the basic knowledge of the MCP protocol.

NPM Package Manager

Get the latest server version.

🚀 Git MCP Server

Git MCP Server is a version control system implemented based on the Model Context Protocol (MCP). It is mainly used to provide Git repository-related operations and data query functions through a unified interface. The server supports various Git operations, including branch management, remote repository configuration, and viewing commit history. It also exposes Git data in a standard resource format.

🚀 Quick Start

✨ Features

Implements a version control system based on the Model Context Protocol.
Provides a unified interface for Git repository operations and data queries.
Supports multiple Git operations such as branch management and remote repository configuration.
Exposes Git data in a standard resource format.

📦 Installation

Environment Requirements

Operating System: Linux, macOS, or Windows (Linux is recommended).
Node.js: Version 14.0 or higher.
npm: Version 6.0 or higher.
Git: Version 2.35 or higher.

Installation Steps

Clone the repository:

git clone git://github.com/yourusername/git-mcp-server.git
cd git-mcp-server

Install dependencies:

npm install

Start the server:

node index.js

📚 Documentation

Resource Description

Git MCP Server exposes Git data in a standard resource format. The following are the main resource interfaces:

Repository Resources

Resource Path	Description
`git://repo/{repoPath}/info`	Provides basic information about the Git repository, including the current branch, status, and reference details.
`git://repo/{repoPath}/branches`	Lists all branches in the repository and the current branch identifier.
`git://repo/{repoPath}/remotes`	Displays all configured remote repositories in the repository and their URLs.
`git://repo/{repoPath}/tags`	Shows all tags in the repository and their reference information.
`git://repo/{repoPath}/file/{filePath}?ref={ref}`	Returns the content of a specified file under a specific Git reference.
`git://repo/{repoPath}/ls/{dirPath}?ref={ref}`	Lists the files and subdirectories in a directory under a specific path and reference.
`git://repo/{repoPath}/diff/{fromRef}/{toRef}?path={path}`	Provides a difference report between two Git references (e.g., commits, branches, tags).
`git://repo/{repoPath}/diff-unstaged?path={path}`	Displays the diff information of all unstaged changes in the working directory.
`git://repo/{repoPath}/diff-staged?path={path}`	Returns the diff content of all staged changes in the index.
`git://repo/{repoPath}/log?maxCount={maxCount}&file={file}`	Retrieves the commit history, supporting the specification of the maximum number of returns and a specific file.
`git://repo/{repoPath}/blame/{filePath}`	Provides line-by-line tracing information, showing the details of the most recent commit that modified each code line.
`git://repo/{repoPath}/commit/{commitHash}`	Displays detailed information about a specific commit, including the change diff.

Development Guide

Build and Test

# Build the project
npm run build

# Monitor file changes and automatically rebuild
npm run watch

# Perform local testing using the MCP inspector tool
npm run inspector

# Clean up build artifacts
npm run clean

# Generate a directory tree view of the documentation
npm run tree

# Rebuild after a full clean
npm run rebuild