🚀 使用 Cursor 做本地 PR Code Review 的实践分享
最近公司给每位开发都配上了 Cursor，刚好我们也在重写客户端 App，技术栏全面更新，这时候探索 AI 在开发流程中的落地场景就显得非常有价值。
这篇文档主要分享一个实用场景：如何在本地使用 Cursor 进行 PR 代码审查（Code Review） 。
🛠 ️ 前置准备
-
安装 Cursor
-
安装 Docker （MCP 工具依赖）
-
生成 GitHub Access Token
- 进入 GitHub 设置：Settings > Developer Settings > Personal access tokens > Tokens (classic)
- 推荐使用 "New personal access token (classic)"
- 权限不用全选，只需要勾选
repo - 如果是公司项目，请确保该 token 已通过 SSO (单点登录) 授权 config 连接到公司组织，否则无法读取 repo。
-
将 GitHub 接入 Cursor
打开 MCP 配置页面，点击 "Add GitHub to Cursor" ，粘贴剑前生成的 token
-
验证是否连接成功
打开 Cursor 设置：
Settings→Tools and Integrations→MCP Tools→GitHub如果显示绿色状态，例如
67 tools enabled，说明连接成功；如果是红色，请参见末尾Troubleshooting部分。
✅ 推荐使用方式：本地目录结构 + 自动识别仓库
最推荐的做法是根据 GitHub 仓库地址，在本地创建对应的目录结构，这样 Cursor 就能自动识别项目，不需要每次手动指定路径。
示例：
如果你的仓库地址是：
arduino
https://github.com/aaa/bbb建议你本地通过 git clone 放到：
bash
~/
└── aaa/
└── bbb/ ← 这里是你 clone 下来的 repo这样配置好后，Cursor 会自动识别这个项目对应的 GitHub 仓库，并正确映射 PR、commit 等上下文信息。
如果你在 ~/aaa/ 下 clone 了多个 repo（比如 ccc/、ddd/），Cursor 也能一次性识别并切换。
进入项目后，可以在 Chat 中直接输入：
kotlin
Can you review the PR 14 for this repo?或者可以先让其拉出所有的PR
css
list all prs再告诉具体的pr编号
🧪 补充方式：直接把 PR 链接放入 Chat 里 review
你也可以直接在 Cursor 的 Chat 窗口中输入：
kotlin
Please review this PR: https://github.com/aaa/bbb/pull/123Cursor 会根据提供的链接抽取 PR 内容进行分析。
但是，如果当前打开的项目和 PR 并不对应，有些上下文理解可能不太准确。因此推荐优先使用上面的本地目录映射方式。
📋 （可选）配置 Review 规则
如果团队常规有一些 code review 规范，可以写入 Cursor 里面做为常规 prompt，将在 AI review 时自动使用。
路径：
Settings→Rules
示例内容：
diff
- 所有公共函数必须添加注释
- 所有新增功能必须包含测试用例
- 命名简汇一定使用 camelCase
- UI 组件中不应包含业务逻辑🔥 遇到问题了？看看这里 (Troubleshooting)
如果你在 MCP 设置里 GitHub 状态一直是红色，表示无法成功连接 GitHub，可按照下面顺序排查：
1. 检查 GitHub Token 是否有效
perl
# 检查 token 基本信息
curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/user
# 检查 token 权限范围
curl -I -H "Authorization: token YOUR_TOKEN" https://api.github.com/user | grep -i x-oauth-scopes2. 是否授权给公司组织
如果你用的是公司仓库，GitHub 需要你的 token 通过 SSO 授权连接公司组织。 
3. Docker 是否启动？
Cursor MCP 需要 Docker 服务运行，如果未启动，或启动慢，GitHub 连接会失败 
- 打开 Docker Desktop，确认状态是 Running
- 初次启动需要等待幾秒至十几秒
4. 重新 Toggle GitHub 连接开关
回到 Cursor 配置页： Settings → Tools and Integrations → MCP Tools → GitHub
点击 Toggle （关闭再打开），有时候多试几次能解决问题