English Français العربية

MCP Smart Git

مجتمعي أدوات المطورين

Git helper for conventional commits, pre-PR secret audits and merge conflict resolution.

الشيفرة المصدرية التوثيق

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. ⚡ Smart Git MCP Server & CLI
  2. 🌟 Why mcp-smart-git?
  3. 🚀 Quick Setup (MCP Stdio)
  4. 🛠️ MCP Tools Exposed
  5. 💻 Standalone Terminal CLI Usage
  6. 🧪 Testing & Verification
  7. 📦 Pro Distribution & Power Bundle
  8. 📄 License

⚡ 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:

  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

ToolParametersDescription
git_smart_commitstaged_only?: booleanParses diffs to generate structured Conventional Commits (feat:, fix:, refactor:) with semantic rationale and breaking-change detection.
git_review_diffstaged_only?: booleanRuns 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_conflictsfile_path?: stringScans repository for <<<<<<< HEAD conflict markers and synthesizes clean merge recommendations.
git_release_changelogsince_tag?: stringCategorizes 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

📄 License

MIT License. Authored by rafim_dev.

الأسئلة الشائعة

ما هو MCP Smart Git؟

Git helper for conventional commits, pre-PR secret audits and merge conflict resolution.

كيف أثبّت MCP Smart Git؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل MCP Smart Git مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون MCP Smart Git؟

ينشره rafim-dev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.