Overview
What is Git Stuff Server?
Git Stuff Server is a Node.js application that implements a Model Context Protocol (MCP) server to provide Git‑related functionalities. Its primary tool generates the textual diff of a Git merge commit against its first parent, intended for developers using MCP‑compatible clients.
How to use Git Stuff Server?
Clone the repository, install dependencies with npm install, compile TypeScript with npm run build, then start the server with npm start (or npm run dev for development). The server listens for MCP requests over standard input/output. Once connected via an MCP client, invoke the get_git_merge_diff tool by supplying a commitHash (the SHA of a merge commit) to receive the diff as text.
Key features of Git Stuff Server
- Runs as a standard MCP server using stdio.
- Provides the
get_git_merge_difftool. - Executes a PowerShell script to generate diffs.
- Uses
git show -m --first-parentunder the hood. - Requires Node.js, npm, Git, and PowerShell.
Use cases of Git Stuff Server
- Review merge commit changes against the first parent.
- Automate diff extraction in CI/CD or code review workflows.
- Integrate Git merge analysis into AI‑powered MCP clients.
FAQ from Git Stuff Server
What does the get_git_merge_diff tool do?
It accepts a Git merge commit hash, runs a PowerShell script that executes git show -m --first-parent, and returns the resulting diff content.
What are the prerequisites to run Git Stuff Server?
Node.js, npm, Git, and PowerShell (or pwsh on Linux/macOS) must be installed and available in the system PATH.
How does the server communicate with clients?
The server uses standard input/output (stdio) as its MCP transport layer.
Where is the diff output stored temporarily?
The PowerShell script writes the diff to a file named merge_changes.diff in the server’s current working directory, which is then read and deleted by the Node.js process.
What license does Git Stuff Server use?
The project is licensed under the MIT License, as stated in the package.json file.
