A Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.
A Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.
Please note that mcp-server-git is currently in early development. The functionality and available tools are subject to change and expansion as we continue to develop and improve the server.
git_statusrepo_path (string): Path to Git repositoryReturns: Current status of working directory as text output
git_diff_unstaged
repo_path (string): Path to Git repositoryReturns: Diff output of unstaged changes
git_diff_staged
repo_path (string): Path to Git repositoryReturns: Diff output of staged changes
git_diff
repo_path (string): Path to Git repositorytarget (string): Target branch or commit to compare withReturns: Diff output comparing current state with target
git_commit
repo_path (string): Path to Git repositorymessage (string): Commit messageReturns: Confirmation with new commit hash
git_add
repo_path (string): Path to Git repositoryfiles (string[]): Array of file paths to stageReturns: Confirmation of staged files
git_reset
repo_path (string): Path to Git repositoryReturns: Confirmation of reset operation
git_log
repo_path (string): Path to Git repositorymax_count (number, optional): Maximum number of commits to show (default: 10)Returns: Array of commit entries with hash, author, date, and message
git_create_branch
repo_path (string): Path to Git repositorybranch_name (string): Name of the new branchstart_point (string, optional): Starting point for the new branchgit_checkoutrepo_path (string): Path to Git repositorybranch_name (string): Name of branch to checkoutgit_showrepo_path (string): Path to Git repositoryrevision (string): The revision (commit hash, branch name, tag) to showgit_initrepo_path (string): Path to directory to initialize git repoWhen using uv no specific installation is needed. We will
use uvx to directly run mcp-server-git.
Alternatively you can install mcp-server-git via pip:
pip install mcp-server-gitAfter installation, you can run it as a script using:
python -m mcp_server_gitAdd this to your claude_desktop_config.json:
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "path/to/git/repo"]
}
}"mcpServers": {
"git": {
"command": "docker",
"args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "mcp/git"]
}
}"mcpServers": {
"git": {
"command": "python",
"args": ["-m", "mcp_server_git", "--repository", "path/to/git/repo"]
}
}Add to your Zed settings.json:
"context_servers": [
"mcp-server-git": {
"command": {
"path": "uvx",
"args": ["mcp-server-git"]
}
}
],"context_servers": {
"mcp-server-git": {
"command": {
"path": "python",
"args": ["-m", "mcp_server_git"]
}
}
},You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector uvx mcp-server-gitOr if you've installed the package in a specific directory or are developing on it:
cd path/to/servers/src/git
npx @modelcontextprotocol/inspector uv run mcp-server-gitRunning tail -n 20 -f ~/Library/Logs/Claude/mcp*.log will show the logs from the server and may
help you debug any issues.
If you are doing local development, there are two ways to test your changes:
Run the MCP inspector to test your changes. See Debugging for run instructions.
Test using the Claude desktop app. Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"git": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
"--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
"--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
"mcp/git"
]
}
}
}{
"mcpServers": {
"git": {
"command": "uv",
"args": [
"--directory",
"/<path to mcp-servers>/mcp-servers/src/git",
"run",
"mcp-server-git"
]
}
}Docker build:
cd src/git
docker build -t mcp/git .This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
[
{
"description": "Shows the working tree status",
"inputSchema": {
"properties": {
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path"
],
"title": "GitStatus",
"type": "object"
},
"name": "git_status"
},
{
"description": "Shows changes in the working directory that are not yet staged",
"inputSchema": {
"properties": {
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path"
],
"title": "GitDiffUnstaged",
"type": "object"
},
"name": "git_diff_unstaged"
},
{
"description": "Shows changes that are staged for commit",
"inputSchema": {
"properties": {
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path"
],
"title": "GitDiffStaged",
"type": "object"
},
"name": "git_diff_staged"
},
{
"description": "Shows differences between branches or commits",
"inputSchema": {
"properties": {
"repo_path": {
"title": "Repo Path",
"type": "string"
},
"target": {
"title": "Target",
"type": "string"
}
},
"required": [
"repo_path",
"target"
],
"title": "GitDiff",
"type": "object"
},
"name": "git_diff"
},
{
"description": "Records changes to the repository",
"inputSchema": {
"properties": {
"message": {
"title": "Message",
"type": "string"
},
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path",
"message"
],
"title": "GitCommit",
"type": "object"
},
"name": "git_commit"
},
{
"description": "Adds file contents to the staging area",
"inputSchema": {
"properties": {
"files": {
"items": {
"type": "string"
},
"title": "Files",
"type": "array"
},
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path",
"files"
],
"title": "GitAdd",
"type": "object"
},
"name": "git_add"
},
{
"description": "Unstages all staged changes",
"inputSchema": {
"properties": {
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path"
],
"title": "GitReset",
"type": "object"
},
"name": "git_reset"
},
{
"description": "Shows the commit logs",
"inputSchema": {
"properties": {
"max_count": {
"default": 10,
"title": "Max Count",
"type": "integer"
},
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path"
],
"title": "GitLog",
"type": "object"
},
"name": "git_log"
},
{
"description": "Creates a new branch from an optional base branch",
"inputSchema": {
"properties": {
"base_branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": {
"path": "tsconfig.json",
"type": "blob"
},
"title": "Base Branch"
},
"branch_name": {
"title": "Branch Name",
"type": "string"
},
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path",
"branch_name"
],
"title": "GitCreateBranch",
"type": "object"
},
"name": "git_create_branch"
},
{
"description": "Switches branches",
"inputSchema": {
"properties": {
"branch_name": {
"title": "Branch Name",
"type": "string"
},
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path",
"branch_name"
],
"title": "GitCheckout",
"type": "object"
},
"name": "git_checkout"
},
{
"description": "Shows the contents of a commit",
"inputSchema": {
"properties": {
"repo_path": {
"title": "Repo Path",
"type": "string"
},
"revision": {
"title": "Revision",
"type": "string"
}
},
"required": [
"repo_path",
"revision"
],
"title": "GitShow",
"type": "object"
},
"name": "git_show"
},
{
"description": "Initialize a new Git repository",
"inputSchema": {
"properties": {
"repo_path": {
"title": "Repo Path",
"type": "string"
}
},
"required": [
"repo_path"
],
"title": "GitInit",
"type": "object"
},
"name": "git_init"
}
]