MCP Perforce

Perforce 的模型上下文协议 (MCP) 服务器实现，支持通过 P4 原生命令获取变更列表信息和文件差异。

功能概述

1. get-changelist-files-catalog

获取变更列表中的文件目录，自动检测 CL 类型（Shelved/Affected）。

返回：

• CL 类型（Shelved 未提交 / Affected 已提交）
• CL 描述信息
• 受影响的文件列表（已过滤二进制文件和配置的跳过扩展名）

2. get-file-details

获取变更列表中指定文件的详细差异信息。

diff 策略：

• Shelved (is_shelved=true)：使用 p4 diff2 file file@=<CL> 比较未提交的变更
• Affected (is_shelved=false)：使用 p4 diff2 file#(base_rev) file#rev 比较已提交的变更

配置说明

Cursor MCP 配置

{
    "mcpServers": {
      "p4-review-dev": {
          "command": "uvx",
          "args": [
              "mcp-perforce",
              "--p4config",
              "./path/to/your/p4config.json"
          ]
      }
  }
}

p4config.json 配置

{
  "skip_file_extensions": [".pb.go", ".cs"]
}

编码自适应

服务器启动时会自动通过 p4 set 命令检测 P4CHARSET 配置，并使用对应的编码读取 P4 命令输出：

使用说明

在 Cursor Agent 模式中输入：

帮我review一下3280706

Cursor 将自动：

1. 调用 get-changelist-files-catalog 获取文件列表
2. 根据 CL 类型（Shelved/Affected）调用 get-file-details 获取每个文件的差异
3. 进行代码审查

发布

方式一：一键发布脚本

WSL/Linux/macOS：

chmod +x publish.sh
./publish.sh

方式二：手动发布

rm .venv -rf
rm dist -rf
uv sync
uv pip install twine
uv build
uv run twine upload ./dist/*

更新记录

• 0.4.2 - 升级到 MCP Python SDK 2.0，适配低层 Server API 与工具参数校验，并清理发布脚本中的硬编码凭据
• 0.4.1 - 迁移为独立项目，项目结构优化
• 0.3.0 - 重大重构
  • 移除 Swarm API 依赖，完全使用 P4 原生命令
  • 支持 Shelved (未提交) 和 Affected (已提交) 两种 CL 类型
  • 新增 is_shelved 参数，根据 CL 类型使用不同的 diff 策略
  • 新增编码自适应功能，自动检测 P4CHARSET 配置
  • 移除 get-changelist-diff-native 工具，功能已合并到 get-changelist-files-catalog 和 get-file-details
• 0.2.6 - 新增 skip_file_extensions 配置项，支持自定义跳过的文件扩展名
• 0.2.5 - 新增 get-changelist-diff-native 工具，支持使用P4原生命令获取CL差异
• 0.2.4 - 修复代码提交后，无法获取reviews中的差异信息的BUG