The Git MCP server is a tool for managing Git operations on local repositories. With this server, you can:
List all Git repositories in the configured path
Retrieve the latest Git tag (version and date) for a repository
List commit details (hash, author, date, message) since the last tag, with an option to limit the count
Create new Git tags (lightweight or annotated) in a repository
Push existing Git tags to the default remote
Refresh a repository by checking out the main branch and pulling from all remotes
Supports configuration through environment variables that can be set directly or through a .env file, particularly for specifying the path to Git repositories.
Provides tools for managing local Git repositories, including listing repositories, retrieving and creating tags, listing commits, pushing tags to remote repositories, and refreshing repositories by pulling from remotes.
Git MCP
MCP server for managing Git operations on local repositories.
Installation
Installing via Smithery
To install Git MCP for Claude Desktop automatically via Smithery:
Installing Manually
Related MCP server: GitHub MCP Server Plus
Configuration
Add the MCP server using the following JSON configuration snippet:
Features and Usage
Environment Variables
GIT_REPOS_PATH: Path to the directory containing your Git repositories (required)
You can set this in your environment or create a .env file in the directory where you run the server.
Available Methods
list_repositories
Lists all Git repositories in the configured path.
Parameters: None
Returns: List of repository names
get_last_git_tag
Finds the last Git tag in the specified repository.
Parameters:
repo_name(Name of the Git repository)Returns: Dictionary with
version(tag name) anddate(tag creation date)
list_commits_since_last_tag
Lists commit messages between the last Git tag and HEAD.
Parameters:
repo_name: Name of the Git repositorymax_count(optional): Maximum number of commits to return
Returns: List of dictionaries with
hash,author,date, andmessage
create_git_tag
Creates a new git tag in the specified repository.
Parameters:
repo_name: Name of the git repositorytag_name: Name of the tag to createmessage(optional): Message for annotated tag (if not provided, creates a lightweight tag)
Returns: Dictionary with
status,version(tag name),date(tag creation date), andtype(annotated or lightweight)
push_git_tag
Pushes an existing git tag to the default remote repository.
Parameters:
repo_name: Name of the git repositorytag_name: Name of the tag to push
Returns: Dictionary with
status,remote(name of the remote),tag(name of the tag), andmessage(success message)
refresh_repository
Refreshes a repository by checking out the main branch (or master as fallback) and pulling from all remotes.
Parameters:
repo_name: Name of the git repository
Returns: Dictionary with
status,repository,branch, andpull_results(results for each remote)
Troubleshooting
Repository Not Found: Ensure
GIT_REPOS_PATHis set correctly and the repository existsNo Tags Found: The repository doesn't have any tags yet
Development
Testing
The project includes two test scripts:
test_git_mcp.py- Tests the underlying Git command functionality directly, without using the MCP server.test_mcp_server.py- Tests the MCP server functionality by starting a server instance and making calls to it.
To run the tests: