MCP Smart Git README

⚡ Smart Git MCP Server & CLI

Next-generation Model Context Protocol (MCP) server & CLI for Git workflows.
Semantic Conventional Commits, Pre-PR Secret Audits, Conflict Resolution, and Automated Release Notes for Claude Desktop, Cursor, Command Code, and Cline.

🌟 Why mcp-smart-git?

AI coding assistants are brilliant at writing code, but they have zero hesitation about:

Accidentally staging API keys, .env tokens, or database credentials in unified diffs.
Writing lazy, chaotic commit messages ("update stuff", "fix").
Creating catastrophic merge conflicts during branch merges.

mcp-smart-git gives your AI assistant a senior DevOps partner that analyzes git diffs safely and semantically.

🚀 Quick Setup (MCP Stdio)

1. Cursor (`.cursor/mcp.json`)

config.json

{
  "mcpServers": {
    "smart-git": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-smart-git/dist/index.js"]
    }
  }
}

2. Claude Desktop (`claude_desktop_config.json`)

config.json

{
  "mcpServers": {
    "smart-git": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-smart-git/dist/index.js"]
    }
  }
}

🛠️ MCP Tools Exposed

Tool	Parameters	Description
`git_smart_commit`	`staged_only?: boolean`	Parses diffs to generate structured Conventional Commits (`feat:`, `fix:`, `refactor:`) with semantic rationale and breaking-change detection.
`git_review_diff`	`staged_only?: boolean`	Runs static analysis on diff lines for secret leaks (AWS keys, OpenAI tokens, private keys), `eval()` hazards, and forgotten debug logs. Generates a 0–100 security score.
`git_resolve_conflicts`	`file_path?: string`	Scans repository for `<<<<<<< HEAD` conflict markers and synthesizes clean merge recommendations.
`git_release_changelog`	`since_tag?: string`	Categorizes recent commit history into clean markdown release notes grouped by features, fixes, and chores.
`git_status`	-	Returns clean, token-efficient repository branch and tracking metrics.

💻 Standalone Terminal CLI Usage

No MCP client required! You can also execute it directly from your terminal:

bash

# Clone & install dependencies
git clone https://github.com/rafim-dev/mcp-smart-git.git
cd mcp-smart-git
npm install
npm run build

# Generate conventional commit from current diff
node dist/index.js commit

# Run pre-PR secret audit & security score
node dist/index.js review

# Synthesize conflict resolution
node dist/index.js conflicts

# Generate release changelog
node dist/index.js changelog

(Tip: Run npm link inside the directory to make the mcp-smart-git command globally available anywhere in your shell).

🧪 Testing & Verification

Includes a complete automated test suite (100% passing):

Terminal

npm test

📦 Pro Distribution & Power Bundle

⚡ Download Compiled Zero-Config Bundle on Gumroad ($5.00+ Pay-What-You-Want)
🎮 Download on itch.io ($5.00+ Pay-What-You-Want)
🎁 Get the 2-in-1 AI Developer Power Bundle (Includes mcp-smart-git + schema-bridge-mcp at 20% off)

📄 License

MIT License. Authored by rafim_dev.