Git Commit Message Generator MCP Server

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

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