aicommit-mcp-bundled

MCP (Model Context Protocol) server for aicommit - AI-powered git commit message generation, bundled with aicommit.

Overview

This MCP server allows AI assistants (like Claude) to generate git commit messages for your code changes. It acts as a bridge between LLMs and the aicommit tool, enabling AI-powered version control workflows.

This is the bundled version that automatically installs aicommit for you.

Package Location

📦 NPM Package: @suenot/aicommit-mcp-bundled

Features

• ✅ Generate commit messages using AI based on your repository changes
• ✅ Execute aicommit operations with all available options
• ✅ Check git status to understand your repository state
• ✅ View configured LLM providers for aicommit
• ✅ Support for automatic staging, pushing, and pulling
• ✅ Automatic installation of aicommit during setup

Installation

Prerequisites

• Node.js 14 or higher
• npm or cargo (for aicommit installation)

Installation

# Install the bundled MCP server
npm install -g @suenot/aicommit-mcp-bundled

# During installation, you'll be prompted to choose between npm or cargo for aicommit installation

The installation process will:

1. Install aicommit using npm or cargo (your choice)
2. Guide you through setting up an LLM provider for aicommit
3. Configure everything needed to use the MCP server

Usage

Starting the server

# Start using the globally installed package
mcp-server-aicommit

# Or using npx
npx @suenot/aicommit-mcp-bundled

AI Assistant Integration

Claude Desktop

To use this MCP server with Claude, add it to your Claude configuration:

{
  "mcpServers": {
    "aicommit": {
      "command": "npx",
      "args": ["-y", "@suenot/aicommit-mcp-bundled"]
    }
  }
}

Cursor

Add the following to your Cursor configuration:

{
  "mcpServers": {
    "aicommit": {
      "command": "npx",
      "args": ["-y", "@suenot/aicommit-mcp-bundled"]
    }
  }
}

Windsurf

Add the following to your Windsurf configuration:

{
  "mcpServers": {
    "aicommit": {
      "command": "npx",
      "args": ["-y", "@suenot/aicommit-mcp-bundled"]
    }
  }
}

Cline

Add the following to your Cline configuration:

{
  "mcpServers": {
    "aicommit": {
      "command": "npx",
      "args": ["-y", "@suenot/aicommit-mcp-bundled"]
    }
  }
}

Smithery

Install via Smithery CLI:

npx -y @smithery/cli@latest install @suenot/aicommit-mcp-bundled --client claude --config '{}'

You can also install for different clients by changing the --client parameter:

# For Cursor
npx -y @smithery/cli@latest install @suenot/aicommit-mcp-bundled --client cursor --config '{}'

# For Windsurf
npx -y @smithery/cli@latest install @suenot/aicommit-mcp-bundled --client windsurf --config '{}'

Functionality

This MCP server exposes the following tools:

1. generate_commit_message

Generates a commit message for the current git changes (without actually creating a commit).

Parameters:

• staged_only (boolean): Whether to only consider staged changes (default: true)
• verbose (boolean): Show detailed information about the execution (default: false)
• max_tokens (integer): Maximum number of tokens in the generated commit message (default: 50)

Example usage:

const result = await tools.generate_commit_message({ staged_only: false, max_tokens: 100 });
console.log(result.commit_message);

2. execute_aicommit

Executes aicommit to generate a commit message and create the commit in one step.

Parameters:

• add (boolean): Stage all changes before committing (default: false)
• push (boolean): Push changes after committing (default: false)
• pull (boolean): Pull changes before committing (default: false)
• verbose (boolean): Show detailed information (default: false)
• max_tokens (integer): Maximum number of tokens for the generated commit message (default: 50)

Example usage:

const result = await tools.execute_aicommit({ 
  add: true,
  push: true
});
console.log(result.commit_message);

3. get_git_status

Get the current git status of the repository.

Parameters:

• verbose (boolean): Whether to show detailed status information (default: false)

Example usage:

const result = await tools.get_git_status({ verbose: true });
console.log(result.status);

4. list_aicommit_providers

List configured LLM providers for aicommit.

Example usage:

const result = await tools.list_aicommit_providers();
console.log(result.providers);

Manual Configuration of aicommit

If the automatic configuration of aicommit did not work, you can configure it manually:

# Configure aicommit providers
aicommit --add-provider

License

MIT

Related

• aicommit - The CLI tool this MCP server uses
• @suenot/aicommit-mcp - The non-bundled version of this package (Documentation)
• Model Context Protocol - Learn more about MCP