mcp-server-git-cz

Git Commit Message Generator MCP Server

An intelligent MCP server that automatically generates Conventional Commits style commit messages using LLM providers like DeepSeek and Groq.

Features

• 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

Table of Contents

• Quick Start
• Installation
• Configuration
• Usage
• MCP Client Setup
• Examples
• Contributing
• License
• Support

Quick Start

1. Clone and install:

   git clone https://github.com/FradSer/mcp-server-git-cz.git
   cd mcp-server-git-cz
   uv venv && uv pip install -r requirements.txt
   

2. Configure environment:

   cp .env.example .env
   # Edit .env with your API keys
   

3. Run the server:

   uv run mcp-server-git-cz
   

Installation

Prerequisites

• Python 3.10+
• uv package manager

Step-by-step Installation

1. Clone the repository:

   git clone https://github.com/FradSer/mcp-server-git-cz.git
   cd mcp-server-git-cz
   

2. Create virtual environment and install dependencies:

   uv venv
   uv pip install -r requirements.txt
   

3. Set up environment variables:

   cp .env.example .env
   

   Edit .env file:

   DEEPSEEK_API_KEY=your_deepseek_api_key
   GROQ_API_KEY=your_groq_api_key
   LLM_PROVIDER=deepseek  # or groq
   

Configuration

Environment Variables

Transport Options

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

Usage

The server exposes a single tool: generate_commit_message that analyzes your git diff and generates conventional commit messages.

Basic Example

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())

MCP Client Setup

Note: Replace /path/to/mcp-server-git-cz with your actual project directory path in all configurations below.

Claude Code

# 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

Cursor

Add to Cursor settings:

{
  "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"
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "git-cz": {
      "command": "uv",
      "args": ["run", "--python", "/path/to/mcp-server-git-cz/.venv/bin/python", "-m", "mcp_server_git_cz"],
      "env": {}
    }
  }
}

{
  "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": {}
    }
  }
}

Examples

Using with MCP Clients

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"

The server will:

1. Analyze your current git diff
2. Generate a conventional commit message using AI
3. Return the formatted message for review

Example Output

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

Contributing

We welcome contributions! Please follow these guidelines:

Development Setup

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: make test
5. Commit using conventional commits: git commit -m 'feat: add amazing feature'
6. Push to your branch: git push origin feature/amazing-feature
7. Open a Pull Request

Code Style

• Follow PEP 8 for Python code
• Use Black for code formatting
• Add type hints where appropriate
• Write tests for new features

Reporting Issues

Found a bug? Have a feature request? Please open an issue with:

• Clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Environment details

License

This project is licensed under the MIT License - see the file for details.

Support

• Documentation: Full documentation
• Bug Reports: GitHub Issues
• Feature Requests: GitHub Discussions
• Email:

Acknowledgments

• Conventional Commits specification
• Model Context Protocol framework
• DeepSeek and Groq for AI capabilities
• All contributors who help improve this project