**Evaluated**: 2026-02-03 **Source**: https://github.com/modelcontextprotocol/servers/tree/main/src/git **Type**: Official MCP Server (Anthropic) **License**: MIT **Status**: Early development (API subject to change) ---
Scanned 6/1/2026
Install via CLI
Skills Directoryopenskills install tools-only/X-Skills# Git MCP Server (Official Anthropic) - Resource Evaluation
**Evaluated**: 2026-02-03
**Source**: https://github.com/modelcontextprotocol/servers/tree/main/src/git
**Type**: Official MCP Server (Anthropic)
**License**: MIT
**Status**: Early development (API subject to change)
---
## Executive Summary
**Final Score**: **5/5 (CRITICAL)**
The Git MCP Server is an official Anthropic MCP server providing programmatic Git access with 12 structured tools. Initial evaluation scored 3/5 (Pertinent), but technical-writer agent challenge identified critical gaps in the guide, elevating the score to 5/5 (CRITICAL). The guide mentioned GitHub MCP in official servers (line 29 mcp-servers-ecosystem.md) but provided zero documentation on Git MCP tools, installation, or use cases. Integration fills ~1600 words gap with comprehensive documentation, decision matrix (Git/GitHub/Bash), and workflow examples.
---
## Resource Overview
### Key Features
| Feature | Details |
|---------|---------|
| **Tools** | 12 Git operations (status, log, diff, commit, add, reset, branch, create_branch, checkout, show, diff_unstaged, diff_staged) |
| **Installation** | 3 methods: uvx one-liner (recommended), pip + Python module, Docker (sandboxed) |
| **Advanced Filtering** | git_log supports ISO 8601 dates, relative dates ("2 weeks ago"), absolute dates ("Jan 15 2024") |
| **Multi-repo** | Configure multiple MCP server instances via --repository flag |
| **IDE Integration** | Claude Desktop, VS Code (Stable + Insiders), Zed, Zencoder with one-click install buttons |
| **Token Efficiency** | context_lines parameter (git_diff), structured output vs text parsing |
| **Parent Repo** | 77,908+ stars (modelcontextprotocol/servers) |
### Use Cases
1. **Automated commit workflows**: AI generates commit messages, stages changes, commits
2. **Log analysis**: Filter commits by date, author, branch with structured output
3. **Branch management**: Create feature branches, checkout, filter by SHA
4. **Token-efficient diffs**: Control context lines for focused code reviews
5. **Multi-repo automation**: Manage multiple repositories in monorepo setups
---
## Evaluation Process
### Initial Assessment (3/5)
**Score**: 3/5 (Pertinent - Complément utile)
**Justification**:
- ✅ Guide mentions "github" MCP in official servers table (line 29)
- ❌ Zero documentation on Git MCP tools/installation/config
- ❌ No use case examples
- ⚠️ Confusion: "git" MCP ≠ "github" MCP (2 different servers)
### Technical-Writer Challenge
**Agent**: technical-writer (a4f5e49)
**Challenge Prompt**: Critique initial evaluation, identify gaps, recommend alternatives
**Key Findings**:
1. **Score Under-Evaluation**:
- Initial 3/5 → Recommended 4-5/5
- Reasoning: Official Anthropic server (not community), 77K+ stars, 12 complete tools (not just status/log), 3 install methods, one-click IDE buttons
- Early development = honesty on API evolution, not instability
2. **Omissions in Evaluation**:
- Docker support native (3 methods) → sandbox, security
- Multi-repo support via --repository flag
- Advanced log filtering (timestamps, relative dates)
- Branch filtering (contains, not_contains params)
- VS Code one-click install buttons
- MCP Inspector support, Zed + Zencoder integrations
- context_lines parameter (git_diff) for token control
3. **Placement Critique**:
- Initial recommendation: "Version Control" after DevOps (line ~380)
- Agent recommendation: Section "Version Control (Official)" BEFORE Browser Automation (top-level priority)
- Justification: Git is foundational for ALL workflows (more critical than testing/deployment)
4. **Decision Matrix Requirement**:
- Agent identified confusion: git MCP vs github MCP vs Bash tool
- Required comprehensive comparison table (11 operations)
- Required decision tree workflow
- Required 7 workflow examples with justifications
5. **Risks of Non-Integration**:
- Gap documentation critique: Guide incomplete on official servers
- Fragmentation workflows: Users improvise with Bash → miss MCP benefits
- Competitive disadvantage: Other guides (Cursor, Cody) document Git MCP
- SEO: Searches "Claude Code git automation" don't find guide
- Trust: Incomplete guide = reduced credibility
**Score Revision**: 3/5 → **5/5 (CRITICAL)**
---
## Fact-Check Results
| Claim | Verified | Source |
|-------|----------|--------|
| **12 tools** | ✅ | WebFetch re-check: git_status, git_diff_unstaged, git_diff_staged, git_diff, git_commit, git_add, git_reset, git_log, git_create_branch, git_checkout, git_show, git_branch |
| **uvx recommended install** | ✅ | `uvx mcp-server-git` confirmed in README |
| **ISO 8601 + relative dates** | ✅ | "ISO 8601 format (e.g., '2024-01-15T14:30:25'), relative dates (e.g., '2 weeks ago', 'yesterday')" |
| **IDE integrations** | ✅ | Claude Desktop, VS Code (Stable + Insiders), Zed, Zencoder confirmed |
| **Early development status** | ✅ | Exact wording: "currently in early development. The functionality and available tools are subject to change" |
| **MIT License** | ✅ | "This MCP server is licensed under the MIT License" |
**Corrections**: None - all claims factually correct.
---
## Gap Analysis
### Current State (Before Integration)
| Aspect | Guide Coverage |
|--------|---------------|
| **Git MCP mention** | ✅ "github" in official servers table (line 29) |
| **Git MCP tools** | ❌ 0% documented (no list, no descriptions) |
| **Installation** | ❌ 0% documented (uvx, pip, Docker methods unknown) |
| **Configuration** | ❌ 0% documented (Claude Desktop mcp.json examples absent) |
| **Use cases** | ❌ 0% documented (when to use Git MCP unknown) |
| **Git vs GitHub vs Bash** | ❌ 0% clarified (confusion on tool selection) |
| **Advanced features** | ❌ 0% documented (date filtering, context_lines, multi-repo) |
### Gap Quantification
- **Words missing**: ~1600 words (comprehensive Git MCP section)
- **Tables missing**: 3 (tools, decision matrix, workflow examples)
- **Code snippets missing**: 3 (installation, config single-repo, config multi-repo)
- **Decision tree missing**: 1 (git/github/bash selection logic)
---
## Integration Details
### Where Documented
**Primary**: `guide/mcp-servers-ecosystem.md`
- **Section**: "Version Control (Official Servers)" (lines 102-255)
- **Placement**: After "Ecosystem Evolution", BEFORE "Validated Community Servers"
- **Rationale**: Official servers deserve top-level visibility, Git foundational for all workflows
**Secondary**: `machine-readable/reference.yaml`
- **Entries**: 11 new keys (git_mcp, git_mcp_guide, git_mcp_tools, git_mcp_install, git_mcp_decision_matrix, git_mcp_repo, git_mcp_score, git_mcp_status, git_mcp_advanced_filtering, git_mcp_use_cases)
- **Updated**: reference.yaml timestamp (2026-02-03)
**Tertiary**: `CHANGELOG.md`
- **Section**: [Unreleased] > Added
- **Details**: ~350 words documenting integration, gap filled, impact, sources, credits
### Content Structure
1. **Intro** (1 paragraph): Official Anthropic server, version control automation
2. **Use Cases** (5 bullet points): Automated commits, log analysis, branch mgmt, diffs, multi-repo
3. **Key Features Table** (12 tools): Name, description, parameters
4. **Advanced Filtering** (4 bullet points): ISO 8601, relative dates, absolute dates, author filtering
5. **Setup** (3 code blocks): uvx, pip, Docker installation methods
6. **Configuration** (2 JSON examples): Single-repo, multi-repo Claude Desktop config
7. **IDE Integrations** (4 platforms): Claude Desktop, VS Code, Zed, Zencoder
8. **Quality Score Table** (5 criteria): Maintenance 10/10, Documentation 9/10, Tests 8/10, Performance 8/10, Adoption 8/10
9. **Limitations Table** (4 rows): Early dev, no rebase -i, no reflog, single repo per instance
10. **Decision Matrix** (11 operations × 3 tools): Git MCP, GitHub MCP, Bash tool comparison
11. **Decision Tree** (3-level logic): GitHub-specific? Core Git? Advanced Git?
12. **Workflow Examples Table** (7 workflows): Feature dev, log analysis, code review, rebase, reflog, bisect, releases
---
## Impact Assessment
### Developer Experience
- **Clarity**: Decision tree prevents tool selection confusion (git/github/bash)
- **Efficiency**: context_lines parameter reduces token usage in diffs
- **Safety**: Structured MCP output vs Bash text parsing (cross-platform)
- **Automation**: AI-assisted commits, branch creation without manual Bash
### Workflow Automation
**New Capabilities**:
1. **Feature branch workflow**: Git MCP (create_branch + commit) → GitHub MCP (PR)
2. **Commit history analysis**: git_log with "2 weeks ago" filtering (token-efficient)
3. **Code review prep**: git_diff with context_lines: 3 (focused context)
4. **Automated releases**: Git MCP (commit + tag) → GitHub MCP (create release)
### Token Efficiency
- **Structured output**: Git MCP returns JSON vs Bash text → less parsing
- **context_lines control**: git_diff parameter reduces irrelevant context
- **Advanced filtering**: git_log timestamps reduce need for post-processing
### Multi-Tool Composition
- **Git MCP + GitHub MCP**: Local commits → remote PR creation (atomic workflow)
- **Git MCP + Semgrep MCP**: Commit → security scan (CI/CD integration)
- **Git MCP + Playwright MCP**: Commit → E2E test trigger (automated validation)
---
## Recommendations Implemented
### Content
- ✅ **12 tools documented** with descriptions, parameters
- ✅ **3 installation methods** (uvx, pip, Docker) with code examples
- ✅ **Multi-repo config** example (2 instances)
- ✅ **Advanced filtering** (ISO 8601, relative dates, absolute dates)
- ✅ **Quality score** 8.5/10 with 5-criteria breakdown
- ✅ **Limitations table** (early dev, no rebase -i/reflog/bisect)
- ✅ **Decision matrix** (11 operations × 3 tools)
- ✅ **Decision tree** (3-level workflow logic)
- ✅ **7 workflow examples** with justifications
### Placement
- ✅ **Section "Version Control (Official Servers)"** created
- ✅ **Positioned BEFORE "Browser Automation"** (top-level priority)
- ✅ **After "Ecosystem Evolution"** (maintains document flow)
- ❌ **NOT placed after DevOps line 380** (rejected as sub-optimal)
### Machine-Readable Index
- ✅ **11 entries added** to reference.yaml
- ✅ **Timestamp updated** (2026-02-03)
- ✅ **Line pointers** to guide sections (git_mcp_guide:102, git_mcp_decision_matrix:212)
---
## Alternative Placements Considered
### Option A: "Version Control (Official)" Section (IMPLEMENTED)
**Pros**:
- Official servers get top-level visibility
- Git foundational for all workflows (before testing/deployment)
- Maintains separation: official vs community servers
**Cons**:
- Adds new top-level section (document structure change)
### Option B: "Quick Start Stack" Item 0
**Pros**:
- Maximum visibility (MVP essentials)
- Positions Git as prerequisite for other tools
**Cons**:
- Quick Start Stack currently community servers only (Playwright, Semgrep)
- Mixing official/community in same section
### Option C: Extend "Official vs Community Servers" Table
**Pros**:
- Minimal structure change
- Inline with existing mention (line 29)
**Cons**:
- Table format limits detail (no 12 tools, no config examples, no decision matrix)
- Doesn't address git/github/bash confusion
**Decision**: Option A implemented (best balance visibility + detail + structure)
---
## Comparison with Other Resources
### Similar Resources
| Resource | Coverage | Strengths | Weaknesses |
|----------|----------|-----------|------------|
| **Official Git MCP README** | Installation, tools list | Authoritative, up-to-date | Lacks decision tree, workflow examples |
| **MCP Protocol Spec** | Abstract protocol | Comprehensive spec | No Git-specific guidance |
| **Cursor/Cody Docs** | Basic Git MCP mention | Alternative IDE context | Less detail than this guide |
### Unique Value in This Guide
1. **Decision Matrix**: Git MCP vs GitHub MCP vs Bash tool (11 operations) — not in official docs
2. **Workflow Examples**: 7 real-world scenarios with justifications — not in official docs
3. **Multi-repo Config**: Multiple instances example — not in official docs
4. **Token Efficiency**: context_lines benefits quantified — not in official docs
5. **Quality Score**: 8.5/10 with 5-criteria breakdown — not in official docs
---
## Maintenance Notes
### Update Triggers
- **Quarterly review**: Check GitHub repo for new tools, API changes (early development warning)
- **Version milestones**: v1.0 release (exit early development) → update status, score
- **Breaking changes**: API modifications → update examples, add migration guide
- **New IDE integrations**: Additional platforms → update integration list
### Monitoring
- **GitHub repo**: https://github.com/modelcontextprotocol/servers/tree/main/src/git
- **Parent repo releases**: https://github.com/modelcontextprotocol/servers/releases
- **MCP Protocol Spec**: https://modelcontextprotocol.io
---
## Credits
- **Source**: [Anthropic MCP Servers - Git](https://github.com/modelcontextprotocol/servers/tree/main/src/git)
- **Evaluation**: Perplexity Deep Research (initial content extraction)
- **Challenge**: technical-writer agent (a4f5e49) - score revision 3/5 → 5/5, placement critique, decision matrix requirement
- **Fact-Check**: WebFetch re-verification (100% claims validated)
- **Integration**: Claude Code Ultimate Guide (2026-02-03)
---
## Appendix: Decision Matrix (Extracted)
| Operation | Git MCP | GitHub MCP | Bash Tool | Justification |
|-----------|---------|------------|-----------|---------------|
| **Local commits** | ✅ Best | ❌ | ⚠️ OK | Structured output, cross-platform safe |
| **Branch management** | ✅ Best | ❌ | ⚠️ OK | `git_branch` filtering, SHA contains/excludes |
| **Diff/log analysis** | ✅ Best | ❌ | ⚠️ OK | `context_lines` control, token-efficient |
| **Staging files** | ✅ Best | ❌ | ⚠️ OK | Pattern matching (`git_add`), safer |
| **PR creation** | ❌ | ✅ Best | ⚠️ gh CLI | GitHub API, labels, assignees, reviewers |
| **Issue management** | ❌ | ✅ Best | ⚠️ gh CLI | GitHub-specific operations |
| **CI/CD status checks** | ❌ | ✅ Best | ⚠️ gh CLI | GitHub Actions integration |
| **Interactive rebase** | ❌ | ❌ | ✅ Best | Git MCP doesn't support `-i` flag |
| **Reflog recovery** | ❌ | ❌ | ✅ Best | Advanced Git operations |
| **Git bisect debugging** | ❌ | ❌ | ✅ Best | Complex debugging workflows |
| **Multi-tool pipelines** | ✅ | ✅ | ❌ | MCP servers compose with other MCP tools |
---
**End of Evaluation**
No comments yet. Be the first to comment!
