io.github.rog0x/git

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

Git log, diff, blame, branch stats for AI agents

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @rog0x/mcp-git-tools
Claude Code
claude mcp add git -- npx -y @rog0x/mcp-git-tools@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "git": {
            "command": "npx",
            "args": [
                "-y",
                "@rog0x/mcp-git-tools@1.0.1"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. mcp-git-tools
  2. Tools
  3. Prerequisites
  4. Setup
  5. Configuration
  6. Tool Details
  7. License

mcp-git-tools

Git repository analysis tools for AI agents, served over MCP (Model Context Protocol). Analyzes local repositories using native git commands — no GitHub API required.

Tools

ToolDescription
git_logGet commit history with filtering by author, date range, and file path
git_diffShow diff between commits, branches, or tags with change summaries
git_blameShow who last modified each line of a file with commit info
git_statsRepository statistics: commits, contributors, activity over time, most changed files
git_branchList branches with last commit info, ahead/behind counts, merged/unmerged status

Prerequisites

  • Node.js >= 18
  • Git installed and available in PATH

Setup

npm install
npm run build

Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "git-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-git-tools/dist/index.js"]
    }
  }
}

Tool Details

git_log

Retrieve recent commit history with optional filters.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • count — Number of commits to return (default: 20)
  • author — Filter by author name or email
  • since / until — Date range filters
  • path — Filter to commits touching a specific file or directory
git_diff

Compare two refs and get a structured summary of changes.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • from — Start ref (default: HEAD~1)
  • to — End ref (default: HEAD)
  • path — Limit diff to a specific file or directory
  • summaryOnly — Return only stats without full diff text
git_blame

See line-by-line authorship of a file.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • filePath (required) — File path relative to repo root
  • startLine / endLine — Blame a specific line range
  • ref — Blame at a specific commit
git_stats

Get a high-level overview of repository activity.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • topAuthors — Number of top contributors to list (default: 10)
  • topFiles — Number of most-changed files to list (default: 10)
git_branch

List and analyze branches.

Parameters:

  • repoPath (required) — Absolute path to the Git repository
  • baseBranch — Branch to compare against (default: main or master)
  • includeRemote — Include remote-tracking branches
  • mergedOnly / unmergedOnly — Filter by merge status

License

MIT

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

ما هو io.github.rog0x/git؟

Git log, diff, blame, branch stats for AI agents

كيف أثبّت io.github.rog0x/git؟

يعمل على جهازك. في Claude Code: claude mcp add git -- npx -y @rog0x/mcp-git-tools@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.rog0x/git إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.rog0x/git مفتوح المصدر؟

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

من يصون io.github.rog0x/git؟

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

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.