lazygit-mcp-bridge

Name: lazygit-mcp-bridge
Availability: InStock
Author: Shu Kutsuzawa

Bridge between lazygit and AI assistants via Model Context Protocol (MCP)

GitHub

GitHubスター

ユーザー評価

未評価

フォーク

イシュー

閲覧数

お気に入り

README

lazygit-mcp-bridge

Bridge between lazygit and AI assistants via Model Context Protocol (MCP)

Overview

lazygit-mcp-bridge enables seamless integration between lazygit and AI coding assistants (like Claude, ChatGPT, etc.) through the Model Context Protocol. When you're reviewing code changes in lazygit, you can instantly send comments and context to your AI assistant without copy-pasting.

Features

📝 Send code diff comments directly from lazygit
🚀 Real-time message delivery via file watching
🤖 Works with any MCP-compatible AI assistant
⚡ Zero-copy workflow - no manual clipboard operations needed
🔧 Single binary with both server and client functionality
🗂️ Multiple message accumulation with deduplication

Installation

1. Install the tool

go install github.com/cappyzawa/lazygit-mcp-bridge/cmd/lazygit-mcp-bridge@latest

2. Configure Claude Code

Add to your Claude Code MCP settings:

"mcpServers": {
  "lazygit-mcp-bridge": {
    "command": "lazygit-mcp-bridge",
    "args": ["server"]
  }
}

Or use the CLI:

claude mcp add lazygit-mcp-bridge lazygit-mcp-bridge server

3. Configure lazygit

Add to your ~/.config/jesseduffield/lazygit/config.yml:

customCommands:
- key: "<c-y>"
  context: "staging"
  description: "Send comment to AI assistant"
  loadingText: "Sending comment…"
  prompts:
  - type: "input"
    title: "Comment:"
  command: |
    lazygit-mcp-bridge send \
      --file "{{ .SelectedPath }}" \
      --comment "{{ index .PromptResponses 0 }}"

That's it! No shell scripts needed anymore. The lazygit-mcp-bridge binary handles everything.

Usage

Basic Usage

Open lazygit
Navigate to the diff view
Press Ctrl+Y
Enter your comment
The AI assistant receives your message automatically!

Using Custom Commands (Recommended)

For the best experience, set up a custom Claude Code command:

Create the command directory in your project:
```
mkdir -p .claude/commands
```

Create .claude/commands/lg.md:

---
allowed-tools: mcp__lazygit-mcp-bridge__check_lazygit_messages
description: Check for new lazygit comments and provide concise code improvement suggestions
---

# lazygit Comment Check

Use the MCP tool `mcp__lazygit-mcp-bridge__check_lazygit_messages` to retrieve the latest comment from lazygit.

Then provide concise, focused code improvement suggestions based on the received message.

Keep responses brief and actionable.

Additional context: $ARGUMENTS

Now you can use /project:lg in Claude Code to instantly check for lazygit messages!

How it works

When you press Ctrl+Y in lazygit, it executes the custom command
The send subcommand creates a JSON message file
The MCP server (running as server subcommand) watches for file changes
When detected, it queues messages with deduplication
Your AI assistant retrieves all accumulated messages via MCP tools

Command Line Interface

# Run as MCP server
lazygit-mcp-bridge server

# Send a message from lazygit (usually called automatically)
lazygit-mcp-bridge send --file main.go --comment "Add error handling for line 42"

# Show help
lazygit-mcp-bridge --help
lazygit-mcp-bridge server --help
lazygit-mcp-bridge send --help

Multiple Message Support

The tool supports multiple message accumulation:

Messages no longer overwrite each other
Up to 10 messages are retained in memory
SHA-256 hash-based deduplication prevents duplicates
All messages delivered together when requested
Clear separation between messages in the response

Development

# Clone the repository
git clone https://github.com/cappyzawa/lazygit-mcp-bridge
cd lazygit-mcp-bridge

# Install dependencies
go mod tidy

# Build with make
make build

# Run server locally
make run-server

# Install to GOPATH/bin
make install

# Run tests
make test

Project Structure

lazygit-mcp-bridge/
├── cmd/lazygit-mcp-bridge/    # CLI entry point
│   └── main.go                 # Cobra command definitions
├── internal/                   # Internal packages
│   ├── server/                 # MCP server implementation
│   │   └── server.go
│   └── client/                 # Send command implementation
│       └── client.go
├── docs/                       # Documentation
├── Makefile                    # Build automation
├── go.mod                      # Go modules
└── README.md