MCP Git Commit Generator

Generate conventional commit messages from your staged git changes using Model Context Protocol (MCP)

python

8

GitHub Stars

python

Language

6 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": {
    "theoklitosbam7-mcp-git-commit-generator": {
      "command": "uvx",
      "args": [
        "mcp-git-commit-generator"
      ]
    }
  }
}

You can generate conventional commit messages directly from your staged Git changes using the MCP Git Commit Generator. It supports automatic type and scope detection, and offers multiple transport options to fit your workflow, including a local stdio mode for development and a server mode for remote clients.

How to use

To use the MCP Git Commit Generator, connect your MCP client to a locally running server or a Docker container, then generate commit messages based on your current Git staging area.

How to install

Prerequisites you need before starting are Python 3.13.5 or newer, the uv packaging tool, and Git.

Choose one of the supported installation methods below and follow the steps exactly.

Option 1: Using uvx (Recommended)
uvx mcp-git-commit-generator

Option 2: Install from PyPI
pip install mcp-git-commit-generator

Option 3: Using Docker
docker run -i --rm --mount type=bind,src=${HOME},dst=${HOME} ghcr.io/theoklitosbam7/mcp-git-commit-generator:latest

Configuration and start guidance

You can run the server in stdio mode locally or connect via Docker. Use the following configurations as explicit examples you can paste into your MCP client setup.

// Example 1: UVX-based stdio server (recommended)
{
  "servers": {
    "gitgc_uvx": {
      "command": "uvx",
      "args": ["mcp-git-commit-generator"]
    }
  }
}

Security and defaults

When using Docker, ensure your home directory can be accessed by the container if you need to work with repositories outside the container's own filesystem. When running locally with UVX or Python, you interact directly with your system and mounting is not required.

Troubleshooting

If you encounter issues, verify that your Git repository is valid and has staged changes before generating a message. Check that you are connected to the correct server transport (stdio or sse) and that the generator is running.

Developer notes

For development, you can run the server locally using Python or UVX, or test via Docker with the published image.

Available tools

generate_commit_message

Generates a conventional commit message based on your staged git changes.

check_git_status

Checks the current git repository status, including staged, unstaged, and untracked files.