# git-enhanced [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/davidweb3-ctrl/mcp-git-enhanced  
**GitHub Stars:** 1  
**npm Downloads (last month):** 10  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/git-enhanced

## Description
Enhanced Git MCP Server - Code review, commit analysis, and branch management

## Tools
Capabilities this server exposes over MCP:

- **git_diff** — Analyze working tree, staged, branch, commit, or path-specific diffs.
- **git_log** — Review commit history with filters for author, date range, branch, path, and stats.
- **git_branch** — List branches, compare a branch to its base, or suggest cleanup candidates.
- **git_status** — Summarize staged, unstaged, and untracked repository state.
- **git_commit_analyze** — Inspect one commit with metadata, changed files, statistics, and diff output.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "git-enhanced": {
    "command": "npx",
    "args": ["-y","git-enhanced"]
  }
}
```

## Documentation & README

# MCP Git Enhanced

[![CI](https://github.com/davidweb3-ctrl/mcp-git-enhanced/actions/workflows/ci.yml/badge.svg)](https://github.com/davidweb3-ctrl/mcp-git-enhanced/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![MCP](https://img.shields.io/badge/MCP-Git%20maintenance-6f42c1)](https://modelcontextprotocol.io/)

MCP Git Enhanced is a Model Context Protocol server that helps AI coding assistants inspect repository state for day-to-day open-source maintenance.

It gives maintainers structured Git context for code review, commit analysis, branch comparison, and release preparation without asking the assistant to run broad shell commands.

## Why Maintainers Use It

Open-source maintainers spend a lot of time answering the same repository questions before they can review or merge work:

- What changed in this branch?
- Which commits matter for the release notes?
- Is this branch behind the base branch?
- What is staged, unstaged, or untracked?
- Which merged or stale branches need cleanup?

This server exposes those workflows as focused MCP tools so assistants can help with PR review, issue triage, release management, and repository hygiene.

## Available Tools

| Tool | Purpose |
| --- | --- |
| `git_diff` | Analyze working tree, staged, branch, commit, or path-specific diffs. |
| `git_log` | Review commit history with filters for author, date range, branch, path, and stats. |
| `git_branch` | List branches, compare a branch to its base, or suggest cleanup candidates. |
| `git_status` | Summarize staged, unstaged, and untracked repository state. |
| `git_commit_analyze` | Inspect one commit with metadata, changed files, statistics, and diff output. |

## Installation

### From Source

```bash
git clone https://github.com/davidweb3-ctrl/mcp-git-enhanced.git
cd mcp-git-enhanced
npm install
npm run build
```

### Claude Code Configuration

Use the built server from this repository:

```json
{
  "mcpServers": {
    "git-enhanced": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-git-enhanced/dist/index.js"]
    }
  }
}
```

### Future npm Install

The package is published as `@davidweb3-ctrl/mcp-git-enhanced`:

```bash
npm install -g @davidweb3-ctrl/mcp-git-enhanced
```

After publication, clients can use:

```json
{
  "mcpServers": {
    "git-enhanced": {
      "command": "npx",
      "args": ["@davidweb3-ctrl/mcp-git-enhanced"]
    }
  }
}
```

## Example Workflows

### PR Review

```text
Use git_diff to compare this branch with master and summarize the risky files.
Use git_log to list commits since the last release.
Use git_commit_analyze on the largest commit before I review it.
```

### Issue Triage

```text
Use git_log to find recent commits touching src/tools.ts.
Use git_status to check whether the local reproduction has uncommitted changes.
```

### Release Management

```text
Use git_branch compare against master to prepare release notes.
Use git_log with --stat style output to identify user-visible changes.
Use git_branch suggest_cleanup after the release branch is merged.
```

## Tool Examples

### `git_diff`

```json
{
  "repoPath": "/absolute/path/to/repo",
  "target": "HEAD~5",
  "source": "HEAD~10",
  "filePath": "src/",
  "staged": false
}
```

### `git_log`

```json
{
  "repoPath": "/absolute/path/to/repo",
  "maxCount": 20,
  "author": "Maintainer Name",
  "since": "1 week ago",
  "stat": true
}
```

### `git_branch`

```json
{
  "repoPath": "/absolute/path/to/repo",
  "action": "list",
  "includeRemote": true
}
```

```json
{
  "repoPath": "/absolute/path/to/repo",
  "action": "compare",
  "branchName": "feature/pr-review-summary",
  "baseBranch": "master"
}
```

### `git_status`

```json
{
  "repoPath": "/absolute/path/to/repo",
  "short": false
}
```

### `git_commit_analyze`

```json
{
  "repoPath": "/absolute/path/to/repo",
  "commitHash": "abc123"
}
```

## Security Model

MCP Git Enhanced is designed as a read-oriented repository inspection server.

- It runs fixed `git` subcommands through `spawnSync` without shell interpolation.
- It does not expose destructive branch deletion, reset, checkout, rebase, push, or force-push tools.
- It validates that `repoPath` points to a Git repository before executing tool handlers.
- It is intended for local repositories controlled by the user or maintainer.

See [SECURITY.md](https://github.com/davidweb3-ctrl/mcp-git-enhanced/blob/HEAD/SECURITY.md) for reporting and supported-version details.

## Development

```bash
npm install
npm run build
npm test
npm run lint
npm run format:check
```

## Project Files

- [CONTRIBUTING.md](https://github.com/davidweb3-ctrl/mcp-git-enhanced/blob/HEAD/CONTRIBUTING.md): development setup and contribution process.
- [SECURITY.md](https://github.com/davidweb3-ctrl/mcp-git-enhanced/blob/HEAD/SECURITY.md): vulnerability reporting and trust boundaries.
- [ROADMAP.md](https://github.com/davidweb3-ctrl/mcp-git-enhanced/blob/HEAD/ROADMAP.md): planned maintainer workflows and release direction.
- [CHANGELOG.md](https://github.com/davidweb3-ctrl/mcp-git-enhanced/blob/HEAD/CHANGELOG.md): release notes.
- [docs/CODEX_FOR_OSS.md](https://github.com/davidweb3-ctrl/mcp-git-enhanced/blob/HEAD/docs/CODEX_FOR_OSS.md): Codex for Open Source maintenance plan.

## Requirements

- Node.js >= 18.0.0
- Git installed and available in `PATH`

## License

MIT