Git Commit Message Generator

Generates Conventional Commits style messages using AI providers for Git diffs via MCP clients.

python

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fradser-mcp-server-git-cz": {
      "command": "uv",
      "args": [
        "run",
        "--python",
        "/path/to/mcp-server-git-cz/.venv/bin/python",
        "-m",
        "mcp_server_git_cz"
      ],
      "env": {
        "GROQ_API_KEY": "YOUR_GROQ_API_KEY",
        "LLM_PROVIDER": "deepseek",
        "DEEPSEEK_API_KEY": "YOUR_DEEPSEEK_API_KEY"
      }
    }
  }
}

You run an MCP server that automatically generates Conventional Commits style messages for your Git changes. It uses AI providers to produce concise, standardized commit messages that you can review before applying them to your repository.

How to use

To use this MCP server with an MCP client, start the local server as a stdio endpoint and connect your client to its standard input/output streams. The server analyzes your current git changes and returns a conventional commit message that you can review and copy into your workflow. You can integrate this with clients like Claude, Cursor, Gemini CLI, and other MCP-enabled tools by pointing them at the local runtime you start below.

How to install

Prerequisites: install Python 3.10 or newer and ensure you have the uv runtime package manager available.

Step 1: Clone the project repository.

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

Step 2: Create a Python virtual environment and install dependencies.

uv venv
uv pip install -r requirements.txt

Step 3: Set up environment variables for AI providers.

Copy the example environment file and edit keys to enable your AI providers.

cp .env.example .env

Edit .env with your API keys and provider choice

Configuration and running

Configure the environment variables to select your AI provider and API keys. The following variables are used:

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

Start the server

Run the server locally using the stdio transport so you can connect a client directly to its input and output streams.

uv run mcp-server-git-cz

Available tools

generate_commit_message

Analyzes the current git diff and generates a conventional commit message using AI, returning a formatted message for review.

Built by

VeilStrat

AI signals for GTM teams