mcp-merge-guard

MCP server that guards PR merge decisions by validating CI, approvals, conflicts, and branch freshness.

Features

• check-merge-ready - Query-only status check that validates all guards

• guard-merge - Atomic validate-then-merge that refuses if guards fail

  • Optional localRepoPath support updates the local base branch after merge without relying on the clone's remote protocol

Guards

Installation

Requires gh CLI installed and authenticated.

With Nix (recommended)

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "merge-guard": {
      "command": "nix",
      "args": ["run", "github:paolino/mcp-merge-guard"]
    }
  }
}

Or use /settings in Claude Code to add the MCP server through the UI.

From source

git clone https://github.com/paolino/mcp-merge-guard
cd mcp-merge-guard
npm install && npm run build

Add to ~/.claude/settings.json (use absolute path):

{
  "mcpServers": {
    "merge-guard": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-merge-guard/dist/index.js"]
    }
  }
}

Restart Claude Code after adding the configuration.

Usage

Once configured, use the tools in Claude Code:

Check if PR #42 in owner/repo is ready to merge

Merge PR #42 in owner/repo if all guards pass

Documentation

Full documentation at paolino.github.io/mcp-merge-guard

Development

just install   # Install dependencies
just build     # Build TypeScript
just test      # Run tests
just CI        # Full CI pipeline

License

MIT