MCP Git Commit Generator

A Python package implementing the Model Context Protocol (MCP) to generate meaningful Git commit messages by analyzing repository changes.

🚀 Overview

MCP Git Commit Generator is a Python package that leverages the Model Context Protocol (MCP) to analyze your Git repository and generate conventional, context-aware commit messages. It supports multiple deployment modes and integrates seamlessly with DXT and MCP environments.

🛠️ Tool Reference

For a complete list of available tools and their input schemas, see TOOLS.md.

📦 Installation

Prerequisites

• Python 3.11+ (with type hints)

• UV Package Manager (Install UV) or use pip

• Git (for repository operations)

• Desktop Extensions (DXT) (Install DXT) for packaging .dxt files for Claude Desktop

Clone the Repository

git clone https://github.com/LuiccianDev/mcp_git_commit_generator.git
cd mcp_git_commit_generator

Install in Development Mode

pip install -e .

📂 Project Structure

mcp_git_commit_generator/
├── src/
│   ├── core/                  # Core logic and utilities
│   │   └── __init__.py
│   ├── tools/                 # MCP tool implementations
│   │   ├── __init__.py
│   │   ├── commit_analysis.py # Commit message generation logic
│   │   ├── git_operations.py  # Git repository operations
│   │   └── register_tools.py  # Tool registration for MCP
│   ├── __init__.py            # Package metadata
│   ├── __main__.py            # CLI entry point
│   └── server.py              # MCP server implementation
├── tests/                     # Unit and integration tests
│   └── test_commit_analysis.py
├── manifest.json              # DXT packaging manifest
├── TOOLS.md                   # Tool reference documentation
└──README.md                  # Project documentation

🧪 Development

Setup Development Environment

1. Clone the repository and navigate to the project directory.

2. Install development dependencies:

   pip install -e ".[dev]"

3. Install pre-commit hooks:

   pre-commit install

⚙️ Deployment Modes

MCP Git Commit Generator Server supports three deployment modes to fit different workflows and environments:

DXT Package Deployment

Recommended for: Users in the DXT ecosystem who want seamless configuration management.

1. Package the project:

   dxt pack

2. Usage: Once packaged, the tool integrates directly with DXT-compatible clients with automatic user configuration variable substitution.

3. Server Configuration: This project includes manifest.json for building the .dxt package.

For more details, see DXT Package Documentation.

Traditional MCP Server

Recommended for: Standard MCP server deployments with existing MCP infrastructure.

Add to your MCP configuration file (e.g., Claude Desktop's mcp_config.json):

# Build packages
uv build
# Install packages
pip install dist/your_package*.whl

Then configure MCP:

{
  "mcpServers": {
    "mcp_git_commit": {
      "command": "uv",
      "args": ["run", "mcp_git_commit"]
    }
  }
}

Or use this configuration (less recommended):

{
   "mcp-word": {
      "command": "/Users/user/to/repo/.venv/Scripts/python",
      "args": [
        "/Users/user/to/repo/src/mcp_git_commit_generator/server.py"
      ]
   }
}

🤝 Contributing

Contributions are welcome! Please read the contribution guidelines before submitting pull requests.

📜 License

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