git-prompts-mcp-server

# 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. [](https://github.com/ceshine/git-prompts-mcp-server/actions/workflows/run_tests.yml) <p> <a href="https://glama.ai/mcp/servers/@ceshine/git-prompts-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@ceshine/git-prompts-mcp-server/badge" alt="Git Prompts Server MCP server" /> </a> </p> <p> <a href="https://mseep.ai/app/ceshine-git-prompts-mcp-server"> <img width="380" height="132" src="https://mseep.net/pr/ceshine-git-prompts-mcp-server-badge.png" alt="MseeP.ai Security Assessment Badge" /> </a> </p> ## Acknowledgements - This repository draws heavy inspiration from [MarkItDown MCP server](https://github.com/KorigamiK/markitdown_mcp_server) and the example [Git MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/git). - The [AGENTS.md](./AGENTS.md) was adapted from the example sin this blog post: [Getting Good Results from Claude Code](https://www.dzombak.com/blog/2025/08/getting-good-results-from-claude-code/). ## Installation ### Manual Installation 1. Clone this repository 2. 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](https://github.com/zed-industries/zed/pull/33539)) ```json "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 ```json "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: 1. `/git-diff <ancestor_branch_or_commit>`: Populate the diff results between HEAD and the specified ancestor branch or commit. 2. `/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. 3. `/git-cached-diff`: Populate the diff results for the staged changes and HEAD. 4. `/git-commit-messages <ancestor_branch_or_commit>`: Get commit messages between the ancestor and HEAD. Examples: 1. `/generate-pr-desc main` 2. `/git-diff dev` 3. `/git-cached-diff` 4. `/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 be `json` (default) or `text`. ## Release Notes ### 0.3.0 (2025-09-05) - Implemented the MCP tool version of the three MCP prompts: `git-diff`, `generate-pr-desc`, and `git-cached-diff`. This allows for a more integrated experience with MCP-compatible clients. - Added a new command `/git-commit-messages` to get commit messages between a specified ancestor and HEAD. ## License MIT License. See [LICENSE](LICENSE) for details.