git_add
Adds file contents to the staging area
LABSCO SUMMARY
Twelve Git operations over a repository path — the whole read-change-commit loop, and nothing that leaves your machine.
The reading half is what makes it worth wiring up: status, three kinds of diff, a date-bounded log and the contents of any revision, so an agent can establish what actually changed before it proposes anything. The writing half stops at the local repository — staging, commits, branches, checkout — with no push, no merge and no rebase among the tools.
What it is
A Git server for one repository path on your own machine. It reads the working tree, the diffs and the log, and it can stage, commit, branch and check out.
What you get
- The working tree status, plus diffs of what is unstaged, what is staged, and how the tree differs from another branch or commit
- A commit log you can bound by date — ISO timestamps, plain dates, and relative forms like '2 weeks ago' all parse
- The full contents of any single revision, addressed by commit hash, branch or tag
- Staging by file path, and an unstage that clears the whole staging area in one call
- Commits made with a message you supply, answered with the new commit hash
- Branch listings — local, remote or all — narrowed to branches that do or do not contain a given commit
- New branches from a base branch, and a checkout to switch between them
Requirements
No account and no key — it works against a repository path you already have. Run it with uvx from the published package mcp-server-git, or pip install it and run python -m mcp_server_git; the repo also builds a Docker image, mcp/git. Every call takes repo_path, and --repository pins one repository at launch. It runs on the MCP Python SDK 1.x line (mcp>=1.29.0,<2).
Setup effort
One command — uvx mcp-server-git
USE CASES
01
Writing the commit message for work that just got done
Read the staged diff, then commit with a message drawn from it. The call comes back with the new commit hash.
02
Working out what a branch changed before you review it
Diff the current tree against the target branch, then open the individual commits that account for the difference.
03
Reconstructing what happened during one particular week
Bound the log by a start and end timestamp — relative forms like '2 weeks ago' work — and read the commits it returns.
04
Starting a change on a fresh branch
Create the branch off a base, switch onto it, then stage the files that belong to the change.
05
Untangling a staging area that has the wrong files in it
Check the status, clear the staging area in one call, then stage back only what you meant to commit.
12 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
git_branch
List Git branches
git_checkout
Switches branches
git_commit
Records changes to the repository
git_create_branch
Creates a new branch from an optional base branch
git_diff
Shows differences between branches or commits
git_diff_staged
Shows changes that are staged for commit
git_diff_unstaged
Shows changes in the working directory that are not yet staged
git_log
Shows the commit logs
git_reset
Unstages all staged changes
git_show
Shows the contents of a commit
git_status
Shows the working tree status
BEFORE YOU INSTALL
What to know first
Tools you get
12 tools when we connected. The project is in early development and says its available tools may change.
Requires
Requires MCP Python SDK 1.x (mcp>=1.29.0,<2). SDK 2.0 renamed APIs this server uses
Where it runs
All 4 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 12 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx mcp-server-gitMCP Clients
Claude Desktop, Zencoder
JSON
{
"mcpServers": {
"git": {
"command": "uvx",
"args": [
"mcp-server-git",
"--repository",
"<YOUR_PATH_TO_GIT_REPO>"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"git": {
"command": "uvx",
"args": [
"mcp-server-git"
]
}
}
}Zed
ZED · JSON
{
"context_servers": {
"mcp-server-git": {
"command": {
"path": "uvx",
"args": [
"mcp-server-git"
]
}
}
}
}
