Pr Forge

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。

MCP 工具 (9 个)

#	工具	说明
1	get_pr_context	获取 PR 元数据（title/state/draft/SHA/branch/author）
2	get_review_status	读取各 phase Check Run 结论 + 完整审查报告（含聚合状态）
3	get_pr_diff	获取 PR unified diff
4	get_file_content	获取仓库文件内容
5	commit_and_push	提交修复并推送到 PR 分支
6	merge_pr	合并 PR（两层门禁：事实层聚合 + 审查意见）
7	run_pr_checks	执行 config.json 的 check 命令（多阶段），各 phase 独立写 Check Run
8	set_conclusion	修改 Check Run 整体结论，附带审查报告
9	get_review_plan	动态生成审查步骤清单（无参数自动找最新 open PR）

安全模型

• 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