ceshine/git-prompts-mcp-server
If you are the rightful owner of git-prompts-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Git Prompts MCP Server is a Model Context Protocol server that generates prompts based on the content of a Git repository.
Git Prompts MCP Server
This repository provides a Model Context Protocol (MCP) server that offers several commands to generate prompts based on the Git repository's content.
Acknowledgements
- This repository draws heavy inspiration from MarkItDown MCP server and the example Git MCP server.
- The was adapted from the example sin this blog post: Getting Good Results from Claude Code.
Installation
Manual Installation
- Clone this repository
- Install dependencies:
uv sync --frozen
Usage
As a MCP Server for Zed Editor
Add the following to your settings.json:
Since Zed version 0.194.3
- Source of the change: "Use standardised format for configuring MCP Servers" (#33539)
"context_servers": {
"git_prompt_mcp": {
"source": "custom",
"command": "uv",
"args": [
"--directory",
"/path/to/local/git_prompts_mcp_server",
"run",
"git-prompts-mcp-server",
"/path/to/repo/", // parent folder of the .git directory
"--excludes", // exclude files and directories from diff results (the server use fnmatch in the backend)
"*/uv.lock",
"--excludes",
"uv.lock",
"--excludes",
".gitignore",
"--format", // format for diff results
"json" // options: json, text
],
"env": {}
}
}
Prior to Zed version 0.194.3
"context_servers": {
"git_prompt_mcp": {
"source": "custom", // This is required for Zed version 0.193.x.
"command": {
"path": "uv",
"args": [
"--directory",
"/path/to/local/git_prompts_mcp_server",
"run",
"git-prompts-mcp-server",
"/path/to/repo/", // parent folder of the .git directory
"--excludes", // exclude files and directories from diff results (the server use fnmatch in the backend)
"*/uv.lock",
"--excludes",
"uv.lock",
"--excludes",
".gitignore",
"--format", // format for diff results
"json" // options: json, text
]
},
"settings": {}
}
}
Commands
The server responds to the following commands:
/git-diff <ancestor_branch_or_commit>: Populate the diff results between HEAD and the specified ancestor branch or commit./generate-pr-desc <ancestor_branch_or_commit>: Generate a pull request description based on the diff results and commit history between HEAD and the specified ancestor branch or commit./git-cached-diff: Populate the diff results for the staged changes and HEAD./git-commit-messages <ancestor_branch_or_commit>: Get commit messages between the ancestor and HEAD.
Examples:
/generate-pr-desc main/git-diff dev/git-cached-diff/git-commit-messages main
Tools
The server also provides the following tools for MCP-compatible clients:
git-diff: Get a diff between the HEAD and the ancestor branch or commit.git-cached-diff: Get a diff between the files in the staging area (the index) and the HEAD.git-commit-messages: Get commit messages between the ancestor and HEAD.
Environment Variables
The server can be configured with the following environment variables, which can be set in the env section of the Zed settings.json:
GIT_REPOSITORY: The path to the Git repository. This is automatically passed by Zed.GIT_EXCLUDES: A comma-separated list of file patterns to exclude from the diff results (e.g.,"*/uv.lock,*.log").GIT_OUTPUT_FORMAT: The output format for the diff results. Can bejson(default) ortext.
Release Notes
0.3.0 (2025-09-05)
- Implemented the MCP tool version of the three MCP prompts:
git-diff,generate-pr-desc, andgit-cached-diff. This allows for a more integrated experience with MCP-compatible clients. - Added a new command
/git-commit-messagesto get commit messages between a specified ancestor and HEAD.
License
MIT License. See for details.
