mcp-git - Git MCP Server

A Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.

MCP Server Usage

This package is designed to be used as an MCP server with clients like Claude Desktop. Here's how to configure it:

Basic Configuration

Add this to your MCP client configuration:

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": ["-y", "mcp-git"]
    }
  }
}

Advanced Configuration

For custom settings:

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": ["-y", "mcp-git"]
    }
  }
}

Installation Options

As Global Command

npm install -g mcp-git
# or
bun install -g mcp-git

Then use in your MCP config:

{
  "mcpServers": {
    "git": {
      "command": "mcp-git"
    }
  }
}

From Source

1. Clone this repository
2. Install dependencies:

   bun install

3. Build:

   bun run build

4. Run:

   bun run start

Available Git Tools

The server provides these MCP-accessible Git operations:

Repository Operations

• git_status - Show working tree status
• git_init - Initialize new repository
• git_log - View commit history (with max_count parameter)

Change Management

• git_diff_unstaged - View unstaged changes
• git_diff_staged - View staged changes
• git_diff - Compare with branch/commit
• git_add - Stage files
• git_reset - Unstage changes
• git_commit - Create commit

Branch Operations

• git_create_branch - Create new branch
• git_checkout - Switch branches

Content Inspection

• git_show - View commit contents

Development

Prerequisites

• Bun v1.2.8 or later
• Git installed system-wide

Building

bun run build

Testing

bun test

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss proposed changes.

License

MIT