Smart Git

License: MIT MCP Protocol Node.js Platform

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:

1. Accidentally staging API keys, .env tokens, or database credentials in unified diffs.
2. Writing lazy, chaotic commit messages ("update stuff", "fix").
3. 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)

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

2. Claude Desktop (claude_desktop_config.json)

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

🛠️ MCP Tools Exposed

💻 Standalone Terminal CLI Usage

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

# 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):

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.