Skip to main content
Glama

pr-forge v3.0

AI 代码变更安全网关 — Agent 修改代码必须走 PR 审查,验证通过后方可合并

npm version Node.js

pr-forge 是一套 MCP (Model Context Protocol) 工具集,为 AI Agent 提供 PR 审查安全网关。Agent 通过 9 个 MCP 工具完成从获取 PR 上下文、运行验证、生成审查报告到合并的全流程,所有操作受两层门禁(事实层 + 审查意见层)保护。

安装

# 一键接入
npx pr-forge init

# 环境诊断
npx pr-forge doctor

init 自动检测项目类型并生成 .pr-forge/config.json,将 token 存入 ~/.pr-forge/credentials,配置 .claude/mcp.json 和 ~/.codex/.mcp.json。

Related MCP server: ReviewLens MCP Server

MCP 工具 (9 个)

#

工具

说明

1

get_pr_context

获取 PR 元数据(title/state/draft/SHA/branch/author)

2

get_review_status

读取各 phase Check Run 结论 + 完整审查报告(含聚合状态),支持 branch 参数

3

get_pr_diff

获取 PR unified diff

4

get_file_content

获取仓库文件内容

5

commit_and_push

提交修复并推送到 PR 分支(自动创建 PR、支持 reviewer 指派、返回 pr_number)

6

merge_pr

合并 PR(两层门禁:事实层聚合 + 审查意见)

7

run_pr_checks

执行 config.json 的 check 命令(多阶段),各 phase 独立写 Check Run

8

set_conclusion

修改 Check Run 整体结论,附带审查报告(自动校验 SHA 防过期)

9

get_review_plan

动态生成审查步骤清单(无参数返回全部 open PR,支持 reviewer 过滤)

多 Agent 协同

任何 Agent 可提交、审查、合并。提交时通过 reviewer 参数指定审查者(写入 PR body 的 <!-- pr-forge-reviewer: 张三 --> 标记),get_review_plan(reviewer="张三") 自动筛选需处理的 PR。所有操作受两层门禁保护。

GitHub App 授权

pr-forge auth 首次运行时通过 Manifest Flow 创建 GitHub App。后续运行检测已有凭据,调用 GET /app 验证 App 仍有效后直接复用,无需重复授权。App 被删除后运行时自动检测并提示重新授权。

安全模型

  • config.json 防篡改:SHA256 hash 对比 .pr-forge/.approved

  • Token 存储:读 ~/.pr-forge/credentials,文件权限 0o600,目录 0o700

  • 并发控制:run_pr_checks 文件锁 pr-{n}.lock + PID 验活 + 死锁恢复

平台支持

能力

GitHub

Gitee

验证结果

Check Runs API

Commit Status API

审查报告

Check Run output

PR comment

合并阻断

分支保护规则

仓库 CI 检查

要求

  • Node.js >= 20

License

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Enables secure, explainable AI-assisted GitHub pull-request review by exposing seven read-only tools that collect deterministic evidence from PRs, separating retrieval from interpretation.
    7
    -
  • A
    license
    B
    quality
    B
    maintenance
    A security-first MCP gateway that enables AI assistants to safely inspect and interact with GitHub repositories through a controlled, auditable tool layer with policy enforcement and human approval for mutations.
    27
    MIT