合并保护服务

Name: 合并保护服务
Author: paolino

MCP服务器通过验证CI、批准、冲突和分支新鲜度来保护PR合并决策。

在 GitHub 查看 paolino/mcp-merge-guard

使用说明

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

check-merge-ready - Query-only status check that validates all guards
guard-merge - Atomic validate-then-merge that refuses if guards fail
- Default merge method is merge (preserves signed branch commits)
- Rebase is refused unless allowSignatureStripping: true is passed
- Optional localRepoPath support updates the local base branch after merge without relying on the clone's remote protocol

Guard	Description
ci-status	All CI checks passed, none pending or failed
approval	PR is approved (or no review required)
conflicts	No merge conflicts
up-to-date	Branch is current with base (optional, off by default)
merge-method-policy	Rebase refused unless allowSignatureStripping is set

Requires gh CLI installed and authenticated.

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.

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.

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

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

MIT