Skip to main content
Glama
FradSer

Git Commit Message Generator MCP Server

by FradSer
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Git Commit Message Generator MCP Server

Python 3.10+ License: MIT MCP Compatible

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

  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

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

Variable

Description

Default

Required

DEEPSEEK_API_KEY

DeepSeek API key

-

Yes (if using DeepSeek)

GROQ_API_KEY

Groq API key

-

Yes (if using Groq)

LLM_PROVIDER

LLM provider to use

deepseek

No

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

Finding Your Paths

  1. Get virtual environment path:

    cd mcp-server-git-cz uv venv which python # Copy this path

  2. Get project directory:

    pwd # Copy this path

  3. Update configurations with your actual paths

Advanced Configuration

With Environment Variables

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

With Working Directory

{ "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 LICENSE file for details.

Support

Acknowledgments

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FradSer/mcp-server-git-cz'

If you have feedback or need assistance with the MCP directory API, please join our Discord server