Cursor 代码审查 MCP 工具

本工具是一个基于模型上下文协议 (MCP) 的 Cursor 插件，可在 Cursor 中自动生成 git diff 并执行代码审查。

功能

• 比较两个 git 分支之间的代码差异
• 提供详细的代码审查指南
• 支持 Notion 集成，从 Notion 代码块中检索审查指南，并提供默认指南作为后备
• 包含预配置的风格和代码审查指南

Cursor 配置

要在 Cursor 中使用此工具，您需要将以下配置添加到您的 Cursor 设置：

1. 打开 Cursor 设置（通常位于 ~/.cursor/config.json）
2. 添加以下配置：

{
  "mcpServers": {
    "code-review-tool": {
      "command": "npx",
      "args": ["-y", "code-review-mcp-server"],
      "env": {
        "NOTION_API_KEY": "notion_api_key",
        "NOTION_CODE_REVIEW_GUIDELINE_CODE_BLOCK_URL": "notion_code_block_url_here",
        "NOTION_STYLE_GUIDELINE_CODE_BLOCK_URL": "notion_code_block_url_here"
      }
    }
  }
}

通过 Cursor 规则增强 AI 工具的使用

为了与 Cursor 的 AI 助手实现最佳集成，我们建议将以下规则添加到您的 Cursor 规则：

Tools
- Whenever the terms 'code review' and 'base branch' appear in the chat, utilize the codeReview MCP tool to generate a diff and associated instructions. Subsequently, use the generated diff and instructions to conduct a thorough code review of the files of the proposed changes.

此规则指示 AI 在您的对话中检测到相关关键字时自动使用代码审查 MCP 工具，从而显著提高工作流程效率。

参考文档：Cursor 模型上下文协议

Notion 集成设置

1. 请求 Notion API Token

1. 访问 Notion Developers
2. 创建一个新的 Integration
3. 获取 API token

有关详细说明，请参阅：Notion API 授权指南

2. 配置环境变量

该工具需要以下环境变量：

NOTION_API_KEY=your_token_here
NOTION_CODE_REVIEW_GUIDELINE_CODE_BLOCK_URL=your_notion_code_block_url
NOTION_STYLE_GUIDELINE_CODE_BLOCK_URL=your_notion_style_guideline_url

这些可以在您的 Cursor 配置的 env 部分中提供，如上所示。

3. 将 Integration 添加到 Notion 页面

1. 点击您的 Notion 页面上的 Share 按钮
2. 将您的 Integration 添加到页面的共享列表

注意：目前仅支持从 Notion 读取代码块

有关详细说明，请参阅：Notion API 连接指南

用法

在 Cursor 聊天窗口中，输入以下命令：

code review
base branch: branch/any_branch

这将：

1. 比较当前分支和指定的基础分支之间的差异
2. 自动生成 git diff
3. 根据风格和代码审查指南执行审查
4. 提供详细的审查结果和改进建议

审查指南

此工具提供两组默认指南：

1. 风格指南: 包括变量命名、函数命名、常量命名等的代码风格标准。
2. 代码审查指南: 包括基于 SOLID 原则、可读性、不变性等的代码质量标准。

您还可以通过 Notion 集成自定义这些指南。