aicommit-mcp

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

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.

Available Packages

There are two versions of this package available:

1. Regular Version @suenot/aicommit-mcp

The standard package that requires aicommit to be installed separately.

NPM Package: @suenot/aicommit-mcp

2. Bundled Version @suenot/aicommit-mcp-bundled

The bundled package that automatically installs aicommit for you.

NPM Package: @suenot/aicommit-mcp-bundled

Feature Comparison

Feature	Regular	Bundled
Generate AI commit messages
Execute aicommit operations
Check git repository status
View aicommit providers
Automatic staging, pushing, pulling
Automatic installation of aicommit

Quick Installation Guide

Regular Version (aicommit installed separately)

# Install aicommit first
npm install -g @suenot/aicommit
# or
cargo install aicommit

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

Bundled Version (includes aicommit installation)

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

Docker Installation

You can also run the MCP server using Docker:

Regular Version

# Pull the Docker image
docker pull suenot/aicommit-mcp

# Run the container
docker run -p 8888:8888 -v $(pwd):/workspace --name aicommit-mcp suenot/aicommit-mcp

Bundled Version

# Pull the Docker image
docker pull suenot/aicommit-mcp-bundled

# Run the container
docker run -p 8888:8888 -v $(pwd):/workspace --name aicommit-mcp-bundled suenot/aicommit-mcp-bundled

Smithery Deployment

This MCP server is compatible with Smithery and can be deployed to the Smithery marketplace. The server implements “lazy loading” of the aicommit tool, which means:

• Tool listing doesn’t require authentication or configuration
• Authentication and dependencies are only checked when tools are actually called
• The server supports deployment and tool display in the Smithery web interface

Setting up with Smithery

# Using the Smithery CLI
npx -y @smithery/cli@latest install @suenot/aicommit-mcp --client claude --config '{}'

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

Local Installation from Smithery

Both versions of the aicommit MCP server support direct installation from the Smithery web interface:

1. Visit Smithery
2. Click “Continue Anyway” when prompted
3. Select your preferred client (Claude, Cursor, etc.)
4. Click “Install Server”

The installer will guide you through the process:

• For the regular version, you’ll need to install aicommit separately
• For the bundled version, aicommit will be installed automatically

Troubleshooting Local Installation

If you encounter the “Uh oh! This server works best locally…” error:

1. Ensure you have Node.js 14+ installed
2. Install the package manually using npm:

   npm install -g @suenot/aicommit-mcp
   # or for bundled version
   npm install -g @suenot/aicommit-mcp-bundled
   

3. Configure your MCP client (Claude, Cursor, etc.) as shown in the Assistant Integration section

Assistant Integration

Claude Desktop

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

With Docker

To use Docker with Claude Desktop, add this to your configuration:

{
  "mcpServers": {
    "aicommit": {
      "command": "docker",
      "args": ["run", "--rm", "-v", "${workspaceFolder}:/workspace", "suenot/aicommit-mcp"]
      // For bundled version: "args": ["run", "--rm", "-v", "${workspaceFolder}:/workspace", "suenot/aicommit-mcp-bundled"]
    }
  }
}

Cursor

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

Windsurf

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

Cline

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

Smithery

Install via Smithery CLI:

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

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

For complete documentation for each package, please refer to:

• Regular Version Documentation
• Bundled Version Documentation

License

MIT

Related

• aicommit - The CLI tool this MCP server uses
• Model Context Protocol - Learn more about MCP