MCP Git Server

A Model Context Protocol (MCP) server that provides Git version control operations for Claude.

Features

• 📊 Repository Status: Check git status and working tree state
• 🔍 View Changes: Show diffs for staged and unstaged changes
• ➕ Stage Files: Add files to the staging area
• 💾 Commit Changes: Create commits with messages
• 🌿 Branch Operations: List, create, switch, and delete branches
• 📜 View History: Show commit logs
• ⬆️ Push Changes: Push commits to remote repositories
• ⬇️ Pull Changes: Pull updates from remote repositories
• 📦 Clone Repositories: Clone remote repositories
• 🚀 Initialize Repos: Create new git repositories

Installation

1. Prerequisites:

   • Node.js 18+ installed
   • Git installed and configured

2. Install the MCP server:

   cd /Users/bard/Code/mcp-git
   npm install
   

3. Add to Claude Desktop config: Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

   {
     "mcpServers": {
       "git": {
         "command": "node",
         "args": ["/Users/bard/Code/mcp-git/src/index.js"]
       }
     }
   }
   

4. Restart Claude Desktop

Usage

Check Repository Status

git_status({ path: "/path/to/repo" })
git_status({ short: true })  // Short format

View Changes

git_diff()  // Unstaged changes
git_diff({ staged: true })  // Staged changes
git_diff({ file: "README.md" })  // Specific file

Stage Files

git_add({ files: ["README.md", "src/index.js"] })
git_add({ files: ["."] })  // Stage all changes

Commit Changes

git_commit({ message: "Add new feature" })

Branch Operations

git_branch()  // List branches
git_branch({ action: "create", name: "feature/new-feature" })
git_branch({ action: "switch", name: "main" })
git_branch({ action: "delete", name: "old-branch" })

View Commit History

git_log()  // Last 10 commits, one-line format
git_log({ limit: 20, oneline: false })  // Detailed format

Push and Pull

git_push()  // Push current branch to origin
git_push({ branch: "main", force: true })  // Force push specific branch

git_pull()  // Pull current branch from origin
git_pull({ remote: "upstream", branch: "main" })

Clone Repository

git_clone({ url: "https://github.com/user/repo.git" })
git_clone({ url: "git@github.com:user/repo.git", path: "my-repo" })

Initialize Repository

git_init({ path: "/path/to/new/repo" })
git_init({ bare: true })  // Create bare repository

Tool Reference

Tool	Description	Required Args
git_status	Show repository status	None
git_diff	Show changes	None
git_add	Stage files	files
git_commit	Create commit	message
git_branch	Manage branches	None
git_log	Show commit history	None
git_push	Push to remote	None
git_pull	Pull from remote	None
git_clone	Clone repository	url
git_init	Initialize repository	None

Error Handling

The server provides detailed error messages for common issues:

• Repository not found
• Uncommitted changes
• Merge conflicts
• Authentication failures
• Network issues

Development

Testing the server:

# Run directly
node src/index.js

# Test with sample commands
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | node src/index.js

Common Issues

1. "Not a git repository": Ensure you're in a git repository or provide the path parameter
2. Authentication errors: Configure git credentials or SSH keys
3. Push/pull failures: Check network connection and remote repository access

License

MIT