🔧 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

📋 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.