MCP Smart Git
Git helper for conventional commits, pre-PR secret audits and merge conflict resolution.
Install
The installation steps are in the documentation below. Documentation
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
⚡ 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,
.envtokens, 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)
{
"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
| 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:
# 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-mcpat 20% off)
📄 License
MIT License. Authored by rafim_dev.
Frequently asked questions
What is MCP Smart Git?
Git helper for conventional commits, pre-PR secret audits and merge conflict resolution.
How do I install MCP Smart Git?
Follow the installation steps in its documentation, shown on this page and in its repository.
Is MCP Smart Git open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains MCP Smart Git?
It is published by rafim-dev. AI.tn lists it but does not maintain or endorse it.
From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.