🔧 MCP Git Server

A complete Git CLI wrapper for the Model Context Protocol (MCP). Provides 100% of git functionality through MCP tools for AI assistants like Claude.

✨ Features

• 🎯 Complete Git CLI wrapper - All git commands available as MCP tools

• 📝 Repository information - Status, logs, diffs, and commit details

• 🌿 Branch management - Create, delete, switch, and merge branches

• 📦 Staging & commits - Add files, commit changes, reset, and stash

• 🌐 Remote operations - Clone, fetch, pull, push, and remote management

• 🔒 Secure - No credential storage, uses your existing git configuration

Related MCP server: MCP Git Server

📋 Prerequisites

• Git CLI must be installed and accessible in PATH

• Node.js 16+ for running the MCP server

• Existing git configuration (git config --global user.name and user.email)

🚀 Quick Start

Using with npx (recommended)

npx @artik0din/mcp-git

Install globally

npm install -g @artik0din/mcp-git
mcp-git

🔧 MCP Client Setup

Add this server to your MCP client configuration:

Claude Desktop Configuration

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": ["@artik0din/mcp-git"]
    }
  }
}

Other MCP Clients

{
  "name": "git",
  "command": "npx",
  "args": ["@artik0din/mcp-git"]
}

📚 Available Tools

Repository Information

• git_status - Show working tree status

  • path (string, required) - Repository path

  • short (boolean) - Give output in short format

• git_log - Show commit logs

  • path (string, required) - Repository path

  • limit (number) - Number of commits (default: 10)

  • oneline (boolean) - One line per commit

  • branch (string) - Branch name

  • author (string) - Filter by author

  • since (string) - Show commits since date

  • until (string) - Show commits until date

  • grep (string) - Filter by commit message

• git_diff - Show changes between commits/working tree

  • path (string, required) - Repository path

  • staged (boolean) - Show staged changes

  • commit (string) - Compare with commit

  • file (string) - Specific file to diff

  • stat (boolean) - Show diffstat only

• git_show - Show commit details and diff

  • path (string, required) - Repository path

  • commit (string) - Commit SHA (default: HEAD)

  • stat (boolean) - Show diffstat only

Branch Management

• git_branch - List, create, or delete branches

  • path (string, required) - Repository path

  • action (string) - Action: list, create, delete, rename

  • name (string) - Branch name

  • new_name (string) - New name for rename

  • all (boolean) - List all branches including remote

  • force (boolean) - Force delete

• git_checkout - Switch branches or restore files

  • path (string, required) - Repository path

  • branch (string) - Branch to checkout

  • create (boolean) - Create new branch (-b)

  • file (string) - File to restore

• git_merge - Merge branches

  • path (string, required) - Repository path

  • branch (string) - Branch to merge

  • no_ff (boolean) - Create merge commit even if fast-forward possible

  • squash (boolean) - Squash commits

  • message (string) - Merge commit message

  • abort (boolean) - Abort current merge

Staging & Commits

• git_add - Add file contents to staging area

  • path (string, required) - Repository path

  • files (array) - Files to add (use ['.'] for all)

  • all (boolean) - Add all changes (-A)

  • update (boolean) - Update tracked files only (-u)

• git_commit - Record changes to repository

  • path (string, required) - Repository path

  • message (string, required) - Commit message

  • all (boolean) - Automatically stage modified files (-a)

  • amend (boolean) - Amend previous commit

  • allow_empty (boolean) - Allow empty commit

• git_reset - Reset current HEAD to specified state

  • path (string, required) - Repository path

  • commit (string) - Commit to reset to (default: HEAD)

  • mode (string) - Reset mode: soft, mixed, hard (default: mixed)

  • files (array) - Unstage specific files

• git_stash - Stash changes in working directory

  • path (string, required) - Repository path

  • action (string) - Action: push, pop, apply, list, drop, clear

  • message (string) - Stash message (for push)

  • index (number) - Stash index (for pop/apply/drop)

  • include_untracked (boolean) - Include untracked files

Remote Operations

• git_remote - Manage remote repositories

  • path (string, required) - Repository path

  • action (string) - Action: list, add, remove, show, set-url

  • name (string) - Remote name

  • url (string) - Remote URL

• git_fetch - Download objects and refs from remote

  • path (string, required) - Repository path

  • remote (string) - Remote name (default: origin)

  • all (boolean) - Fetch all remotes

  • prune (boolean) - Prune deleted remote branches

  • tags (boolean) - Fetch tags

• git_pull - Fetch and integrate with remote branch

  • path (string, required) - Repository path

  • remote (string) - Remote name (default: origin)

  • branch (string) - Branch name

  • rebase (boolean) - Rebase instead of merge

  • ff_only (boolean) - Fast-forward only

• git_push - Update remote refs and objects

  • path (string, required) - Repository path

  • remote (string) - Remote name (default: origin)

  • branch (string) - Branch name

  • force (boolean) - Force push

  • force_with_lease (boolean) - Force push with lease (safer)

  • set_upstream (boolean) - Set upstream for branch (-u)

  • tags (boolean) - Push tags

  • delete (boolean) - Delete remote branch

• git_clone - Clone a repository

  • url (string, required) - Repository URL

  • destination (string) - Destination directory

  • branch (string) - Branch to checkout

  • depth (number) - Shallow clone depth

  • recursive (boolean) - Clone submodules recursively

🔒 Security

This server uses your existing git configuration and credentials. It does not store or manage any sensitive information:

• Uses system-installed git CLI

• Respects your existing SSH keys and credentials

• No network requests outside of git operations

• All operations performed in specified directories only

📝 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions welcome! Please feel free to submit a Pull Request.