Git Commit Message Generator
About
Generates Conventional Commits style commit messages using LLM providers like DeepSeek and Groq.
Details
- Author
- fradser
- Categories
- Developer Tools, Other
- Tags
- #git
Jump to
Setup
Install Git Commit Message Generator in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/fradser/mcp-server-git-cz
Follow the installation instructions in the repository README, then restart your MCP client.
Generates Conventional Commits style commit messages using LLM providers like DeepSeek and Groq.
An intelligent MCP server that automatically generatesConventional Commitsstyle commit messages using LLM providers like DeepSeek and Groq.
- AI-Powered: Leverages LLM providers (DeepSeek, Groq) for intelligent commit message generation
- Conventional Commits: Follows industry-standard commit message conventions
- Multi-Provider: Supports multiple LLM providers with easy switching
- MCP Compatible: Works seamlessly with Claude, Cursor, Gemini CLI, and other MCP clients
- Easy Setup: Simple configuration via environment variables
- Quick Start
- Installation
- Configuration
- Usage
- MCP Client Setup
- Examples
- Contributing
- License
- Support
git clone https://github.com/FradSer/mcp-server-git-cz.git cd mcp-server-git-cz uv venv && uv pip install -r requirements.txt
cp .env.example .env # Edit .env with your API keys
git clone https://github.com/FradSer/mcp-server-git-cz.git cd mcp-server-git-cz
Create virtual environment and install dependencies:
uv venv uv pip install -r requirements.txt
DEEPSEEK_API_KEY=your_deepseek_api_key GROQ_API_KEY=your_groq_api_key LLM_PROVIDER=deepseek # or groq
The server supports multiple transport methods:
# STDIO transport (recommended) uv run mcp-server-git-cz # SSE transport uv run mcp-server-git-cz --transport sse --port 8000
The server exposes a single tool:generate_commit_messagethat analyzes your git diff and generates conventional commit messages.
import asyncio from mcp.client.session import ClientSession from mcp.client.stdio import StdioServerParameters, stdio_client async def main(): async with stdio_client( StdioServerParameters(command="uv", args=["run", "mcp-server-git-cz"]) ) as (read, write): async with ClientSession(read, write) as session: await session.initialize() # Generate commit message result = await session.call_tool("generate_commit_message", {}) print(result) asyncio.run(main())
Note: Replace/path/to/mcp-server-git-czwith your actual project directory path in all configurations below.
# Project scope (recommended for teams) claude mcp add git-cz -s project -- uv run --python /path/to/mcp-server-git-cz/.venv/bin/python -m mcp_server_git_cz # User scope (personal use) claude mcp add git-cz -s user -- uv run --python /path/to/mcp-server-git-cz/.venv/bin/python -m mcp_server_git_cz
{ "mcpServers": { "git-cz": { "command": "uv", "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"], "env": {}, "transport": "stdio" } } }
{ "mcpServers": { "git-cz": { "command": "uv", "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"], "env": {} } } }
cd mcp-server-git-cz uv venv which python # Copy this path
Update configurationswith your actual paths
{ "mcpServers": { "git-cz": { "command": "uv", "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"], "env": { "DEEPSEEK_API_KEY": "your_key_here", "LLM_PROVIDER": "deepseek" } } } }
{ "mcpServers": { "git-cz": { "command": "uv", "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"], "cwd": "/path/to/mcp-server-git-cz", "env": {} } } }
Once configured, you can interact with the tool using natural language:
- "Generate a commit message for my current changes"
- "Create a conventional commit message based on my git diff"
- "Help me write a commit message following conventional commits"
- Analyze your current git diff
- Generate a conventional commit message using AI
- Return the formatted message for review
feat(auth): add OAuth2 integration with GitHub - Implement OAuth2 authentication flow - Add GitHub provider configuration - Update user model to support external auth - Add tests for authentication endpoints Closes #123
We welcome contributions! Please follow these guidelines:
- Fork the repository
- Create a feature branch:git checkout -b feature/amazing-feature
- Make your changes
- Run tests:make test
- Commit using conventional commits:git commit -m 'feat: add amazing feature'
- Push to your branch:git push origin feature/amazing-feature
- Open a Pull Request
- FollowPEP 8for Python code
- UseBlackfor code formatting
- Add type hints where appropriate
- Write tests for new features
Found a bug? Have a feature request? Pleaseopen an issuewith:
- Clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Environment details
This project is licensed under theMIT License- see theLICENSEfile for details.
- Documentation:Full documentation
- Bug Reports:GitHub Issues
- Feature Requests:GitHub Discussions
- Email:fradser@gmail.com
- Conventional Commitsspecification
- Model Context Protocolframework
- DeepSeekandGroqfor AI capabilities
- Allcontributorswho help improve this project
Git-native decision memory for coding agents, stored as git trailers and refs/notes.
Make git commits on behalf of AI to track AI contributions in your codebase.
Analyze Git repositories and provide content optimized for large language models.
AI drafts the commits, you decide what ships. GitInProgress lets your AI read your uncommitted working tree and propose how to split it into focused commit candidates — each with a draft commit message. Nothing lands in git history until you review and approve; the AI never commits on its own.
An MCP server for interacting with and automating Git repositories using Large Language Models.
Generates Pull Request messages based on Git commits and changes.
Anchor is local repo and org memory for AI coding agents. It indexes GitHub PR history, current code, tests, regressions, architecture, and cross-repo impact locally, then exposes concise cited context through MCP and CLI workflows. Local-first. Read-only GitHub access. No CLI telemetry. No SaaS. No remote LLM calls.
DOS is a small open-source kernel that doesn't believe your AI agents: it verifies what actually shipped from git evidence, arbitrates file collisions between parallel agents, and refuses with structured reasons.
The most comprehensive MCP server for VS Code — 100+ tools across 25 categories. File ops, terminal, git, LSP providers (hover, completion, definition, references), and more. Free core + premium features.
Gitee API integration, repository, issue, and pull request management, and more.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
