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