mcp-git - Git MCP Server

License

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

From Source

Clone this repository
Install dependencies:
```
bun install
```
Build:
```
bun run build
```
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

mcp-git - Git MCP Server