用途
bitbucket-mcp 是一个针对 Bitbucket Cloud 的 MCP（Model Context Protocol）服务器，专注于拉取请求评审的初步流程。它通过 stdio 传输，可与 Claude Code 或 Claude Desktop 配合使用。
主要能力
该服务器提供读取和写入两组工具。
读取（无副作用）
- 读取 PR
- 读取差异（diffs）
- 读取评论
- 读取提交（commits）
- 读取文件
写入（修改 Bitbucket 状态）
- 发布行内评论或常规评论
- 批准（approve）
- 请求更改（request changes）
使用方式
1. 创建 API 令牌
Bitbucket Cloud 应用密码自 2026-06-09 起进入淘汰期，并将在 2026-07-28 移除。因此该服务器使用 API 令牌，HTTP Basic 认证对为 email:token——Bitbucket REST API 要求使用 Atlassian 账户邮箱，而非用户名。使用用户名会导致静默 401 错误。
创建步骤：
- 进入 Bitbucket 顶部栏 → Settings → Atlassian account settings → Security。
- 选择 Create and manage API tokens → Create API token with scopes。
- 命名、设置过期时间，并选择 Bitbucket 作为应用。
- 选择 PR 评审所需的最小作用域：
- read:repository:bitbucket（读取仓库、差异、文件）
- read:pullrequest:bitbucket（读取 PR 和评论）
- write:pullrequest:bitbucket（评论、批准、请求更改）
- 复制令牌（仅显示一次）。
2. 安装与构建
安装和构建后生成 dist/index.js（服务器二进制文件）。具体的安装命令在资料中暂未提供。
3. 在 Claude Code 中配置
将配置添加到项目的 .mcp.json（或全局 Claude Code 配置）中。也可以通过 CLI 进行配置。具体的配置示例在资料中暂未提供。
环境变量 BITBUCKET_WORKSPACE 是可选的；如果省略，则每个工具必须显式指定 workspace。
适用场景
适用于需要自动或辅助进行 Bitbucket Cloud 拉取请求评审的场景，特别是作为“第一遍”评审的子代理，仅建议评审而不实际修改任何内容。也适用于需要读取 PR 相关信息和发布评论、批准或请求更改的自动化工作流。
限制与安全建议
令牌授予对工作区 PR 的读写权限，应将其视为机密：保存在环境变量或机密管理器中，切勿提交到代码仓库。如果希望子代理仅建议评审而不修改任何内容，建议使用只读作用域令牌，这样 approve/comment 操作会因权限不足而失败，而不是依赖提示词的约束。
许可证
MIT © José Danilo
