MCP Server to Auto commit changes 🛠️

This implementation provides a Git changes analyzer that generates commit messages using OpenAI's GPT models.

Demo

Related MCP server: Git Forensics MCP

Features

• Analyzes git changes in your repository (both staged and unstaged)

• Generates conventional commit messages using GPT-4o-mini

• Provides detailed summaries of:

  • 📝 Modified files

  • ✨ Newly added files

  • 🗑️ Deleted files

  • 📄 Detailed changes (up to 10 lines per file)

• Built with @modelcontextprotocol/sdk

• Adds an auto-commit signature to each commit

Project Structure

Prerequisites

• Node.js installed

• OpenAI API key

• Git repository to analyze

• pnpm package manager

Getting Started

1. Clone this repository:

2. Install dependencies:

3. Set up your OpenAI API key using one of these methods:

   • Set as an environment variable: OPENAI_API_KEY=your-api-key

   • Pass as a command line argument: --key your-api-key

   • Add to a .env file in the project root

4. Build the project:

This will generate the /build/index.js file - your compiled MCP server script.

Using with Cursor

1. Go to Cursor Settings -> MCP -> Add new MCP server

2. Configure your MCP:

   • Name: git-auto-commit

   • Type: command

   • Command: node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js --key your-api-key (Replace your-api-key with your actual OpenAI API key if not set in environment)

Using with Claude Desktop

Add the following MCP config to your Claude Desktop configuration:

Available Tools

git-changes-commit-message

This tool analyzes the current git changes in your repository and generates a commit message using OpenAI's GPT-4o-mini model. It provides:

• List of modified files with status indicators

• List of newly added files

• List of deleted files

• Detailed changes for each file (limited to 10 lines per file for readability)

• A generated commit message following conventional commits format

• An auto-commit signature

Usage parameters:

• autoCommitPath: Optional path to analyze specific directory/file. If not provided, uses current working directory.

Development

The implementation in index.ts showcases:

1. Setting up the MCP server with proper configuration

2. Handling command line arguments and environment variables

3. Integrating with OpenAI's API using GPT-4o-mini model

4. Git operations using child processes

5. Error handling and fallback mechanisms

6. Detailed change analysis and formatting

To modify or extend the implementation:

1. Update the server configuration in index.ts:

2. The tool is defined using server.tool() with proper parameter validation using Zod schema.

3. Build and test your changes:

Contributing

Feel free to submit issues and enhancement requests!

License

MIT