Bitbucket MCP Server

社区

用于 Bitbucket Cloud 和 Server API 的模型上下文协议 (MCP) 服务器。

分类: 开发工具第 227 / 438
Stars: ★ 166 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 5 个月前
工具数: 40

52FMRS · D

bitbucket-mcp 是一个功能全面的 MCP 服务器，用于与 Bitbucket Cloud 和 Server 集成，提供广泛的仓库、拉取请求和流水线操作。它强调安全性，默认禁用删除操作，并包含代码扫描。安装简单，环境变量配置清晰，支持 Cursor 等客户端。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

10/20

维护活跃度

10/20

文档质量

14/20

安装易用性

14/20

查看各项评分依据

可靠性 4/20: 提供的材料仅为 README 与 server manifest，不包含任何源码、测试用例或 CI 工作流内容。无法验证服务器能否正常启动、能否完成 MCP 握手，也无法确认工具清单与实际行为是否一致。根据静态校准原则，缺乏可执行证据时可靠性分数必须保守，故仅给 4 分。
安全与权限 10/20: README 声明不包含 DELETE 操作，默认通过 BITBUCKET_ENABLE_DANGEROUS 关闭危险工具，并采用 app password / token 环境变量，安装示例中均为占位符，未发现真实凭据泄露。但无法查看源码验证凭据处理、日志脱敏、网络出口范围及危险操作的二次确认机制，数据流披露也不完整，因此不能给高分。
维护活跃度 10/20: 仓库未归档，许可证为 MIT，npm 版本为 5.0.5，且存在 CodeQL、npm version 徽章，表明有持续发布迹象。但缺少提交频率、发布日期、issue 响应时间等直接证据，无法确认维护治理是否稳健，故给予中等偏保守的 10 分。
文档质量 14/20: README 覆盖了安装、环境变量、工具参数、分页说明、认证故障排查、Cursor 客户端配置和本地构建方式，内容相当全面。但存在分页说明在多个工具下重复、'Checkout out' 等笔误，且未披露成本、速率限制与更细的失败模式，因此扣分后为 14 分。
安装易用性 14/20: 提供了 npx 与 npm 全局/项目安装两种路径，环境变量表清晰，并给出 Cursor 的 MCP JSON 配置示例和本地构建配置示例，步骤较少且可操作性强。唯一不足是没有任何可执行的 CI 测试或运行日志来证明端到端安装流程必然成功，故按静态校准上限给 14 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 Bitbucket Cloud 或 Server 并希望集成 AI 助手的开发者。
需要以编程方式或通过自然语言与 Bitbucket 仓库和 PR 交互的团队。
希望利用 MCP 标准在 Cursor 等工具中操作 Bitbucket 的用户。

不适合谁

需要对 Bitbucket 资源进行删除操作的用户（默认禁用删除工具）。
需要图形用户界面而非命令行或 AI 集成的用户。
没有 Bitbucket 账户或凭据的用户。

所需权限

需要 Bitbucket 应用密码或访问令牌。
根据操作需要至少“仓库：读取”权限。
对于流水线操作，需要“流水线：读取”权限。
对于写操作（如创建/更新 PR），需要“拉取请求：写入”权限。

风险与副作用

使用应用密码或令牌时，如果泄露可能导致未授权访问。
如果凭据权限过大，可能意外修改或删除数据（尽管默认禁用删除工具）。
错误配置可能暴露敏感信息（如错误的日志级别）。

安装接入

准备工作

运行环境：Node.js 18+

BITBUCKET_USERNAME 必填 Bitbucket 用户名，通常填写你的邮箱；与 BITBUCKET_PASSWORD（或 BITBUCKET_TOKEN）二选一必填。

BITBUCKET_PASSWORD 必填密钥 Bitbucket 应用密码（App Password），在 Bitbucket 个人设置的 App Passwords 页面创建，需要 Repositories: Read、Pull requests: Read/Write、Pipelines: Read 权限。

BITBUCKET_TOKEN 可选密钥 Bitbucket 访问令牌，可作为用户名/密码的替代认证方式。

其他可选配置项（7 个）

BITBUCKET_URL 可选 Bitbucket API 基础 URL，默认 https://api.bitbucket.org/2.0，也可填网页 URL 自动提取工作区。

BITBUCKET_WORKSPACE 可选默认工作区名称；若 URL 中已包含工作区则可省略。

BITBUCKET_ENABLE_DANGEROUS 可选设为 true 时启用危险工具（如删除操作），默认关闭。

BITBUCKET_LOG_DISABLE 可选设为 true 或 1 时禁用文件日志。

BITBUCKET_LOG_FILE 可选指定日志文件的绝对路径。

BITBUCKET_LOG_DIR 可选日志存储目录，默认使用操作系统应用日志目录。

BITBUCKET_LOG_PER_CWD 可选设为 true 时按工作目录分子目录存放日志。

确保 Node.js 18 或更高版本。
推荐使用 npx 运行：设置环境变量 (BITBUCKET_URL, BITBUCKET_USERNAME, BITBUCKET_PASSWORD, 可选 BITBUCKET_WORKSPACE)，然后运行 npx -y bitbucket-mcp@latest。
或者全局安装：npm install -g bitbucket-mcp，然后运行 bitbucket-mcp。
在支持的客户端（如 Cursor）中，添加 MCP 配置，使用 npx 命令和所需环境变量。

.cursor/mcp.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "bitbucket-mcp@latest"
      ],
      "env": {
        "BITBUCKET_URL": "https://api.bitbucket.org/2.0",
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-app-password"
      }
    }
  }
}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "bitbucket-mcp@latest"
      ],
      "env": {
        "BITBUCKET_URL": "https://api.bitbucket.org/2.0",
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-app-password"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add bitbucket -e BITBUCKET_URL=https://api.bitbucket.org/2.0 -e BITBUCKET_WORKSPACE=your-workspace -e BITBUCKET_USERNAME=your-username -e BITBUCKET_PASSWORD=your-app-password -- npx -y bitbucket-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端连接后查看工具列表，应出现 listRepositories、getPullRequests、runPipeline 等工具；调用 listRepositories 如果能返回工作区仓库列表，说明认证和连接正常。

常见排障

401 认证错误：确保使用应用密码而非常规密码，并检查权限。
使用 API URL 格式：如果遇到 401，尝试设置 `BITBUCKET_URL=https://api.bitbucket.org/2.0`。
通过 curl 测试 API 访问：`curl -u "username:app-password" "https://api.bitbucket.org/2.0/repositories/workspace"`。
对于 Atlassian API 密钥，将密钥放入 `BITBUCKET_PASSWORD`，用户名使用邮箱。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的工作区里的所有仓库
查看仓库 my-repo 中所有打开的拉取请求
获取拉取请求 #42 的 diff，并在出错的代码行上添加一条内联评论
触发一次仓库 my-repo 的流水线运行，然后显示各步骤的日志

工具能力 40

listRepositories 只读

列出工作区中的仓库，支持按名称筛选和分页。

getRepository 只读

获取特定仓库的详细信息。

getPullRequests 只读

获取仓库的拉取请求列表，可按状态筛选。

createPullRequest 写入

创建新的拉取请求，支持指定源/目标分支、审查者和草稿状态。

getPullRequest 只读

获取特定拉取请求的详细信息。

updatePullRequest 写入

更新拉取请求，如标题、描述等。

getPullRequestActivity 只读

获取拉取请求的活动日志。

approvePullRequest 写入

批准拉取请求。

展开其余 32 个工具

unapprovePullRequest 写入

移除对拉取请求的批准。

declinePullRequest 写入

拒绝拉取请求，可附带原因。

mergePullRequest 写入

合并拉取请求，支持合并策略和提交消息。

requestChanges 写入

请求对拉取请求进行修改。

removeChangeRequest 写入

移除对拉取请求的修改请求。

createDraftPullRequest 写入

创建草稿拉取请求。

publishDraftPullRequest 写入

发布草稿拉取请求，使其可审查。

convertTodraft 写入

将普通拉取请求转换为草稿状态。

getPullRequestComments 只读

列出拉取请求上的评论。

addPullRequestComment 写入

在拉取请求上添加评论，支持一般或内联评论。

getPullRequestComment 只读

获取指定的拉取请求评论。

updatePullRequestComment 写入

更新拉取请求评论内容。

deletePullRequestComment 破坏性

删除拉取请求评论。

resolveComment 写入

解决拉取请求上的评论线程。

reopenComment 写入

重新打开已解决的评论线程。

getPullRequestDiff 只读

获取拉取请求的差异 (diff)。

getPullRequestDiffStat 只读

获取拉取请求的差异统计。

getPullRequestPatch 只读

获取拉取请求的补丁 (patch)。

getPullRequestTasks 只读

列出拉取请求上的任务。

createPullRequestTask 写入

在拉取请求上创建任务。

getPullRequestTask 只读

获取指定的拉取请求任务。

updatePullRequestTask 写入

更新任务内容或状态。

deletePullRequestTask 破坏性

删除任务。

getPullRequestCommits 只读

列出拉取请求的提交。

getPullRequestStatuses 只读

列出拉取请求的提交状态。

listPipelineRuns 只读

列出仓库的流水线运行，支持按状态、分支等筛选。

getPipelineRun 只读

获取特定流水线运行的详细信息。

runPipeline 写入

触发新的流水线运行。

stopPipeline 写入

停止正在运行的流水线。

getPipelineSteps 只读

列出流水线运行的步骤。

getPipelineStep 只读

获取特定流水线步骤的详细信息。

getPipelineStepLogs 只读

获取特定流水线步骤的日志。

使用场景

通过 AI 助手管理 Bitbucket 仓库和拉取请求，如列出仓库、查看 PR、创建 PR、审查和合并。

自动化工作流，如基于 PR 活动触发操作或运行流水线。

在对话界面中获取仓库信息、PR 评论和差异。

支持客户端

Cursor

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

bitbucket-mcp 是一个模型上下文协议 (MCP) 服务器，用于将 AI 助手（如 Cursor）与 Bitbucket 仓库、拉取请求和流水线集成。它提供工具来列出和检索仓库、管理拉取请求（创建、更新、批准、合并等）、处理拉取请求评论、任务、差异以及流水线。该服务器仅通过 stdio 使用，并依赖环境变量进行身份验证。