适合谁
- 使用 Bitbucket Cloud 或 Server 并希望集成 AI 助手的开发者。
- 需要以编程方式或通过自然语言与 Bitbucket 仓库和 PR 交互的团队。
- 希望利用 MCP 标准在 Cursor 等工具中操作 Bitbucket 的用户。
B
52FMRS · D
bitbucket-mcp 是一个功能全面的 MCP 服务器，用于与 Bitbucket Cloud 和 Server 集成，提供广泛的仓库、拉取请求和流水线操作。它强调安全性，默认禁用删除操作，并包含代码扫描。安装简单，环境变量配置清晰，支持 Cursor 等客户端。
bitbucket-mcp 是一个模型上下文协议 (MCP) 服务器，用于将 AI 助手（如 Cursor）与 Bitbucket 仓库、拉取请求和流水线集成。它提供工具来列出和检索仓库、管理拉取请求（创建、更新、批准、合并等）、处理拉取请求评论、任务、差异以及流水线。该服务器仅通过 stdio 使用，并依赖环境变量进行身份验证。
工具能力
listRepositories
列出工作区中的仓库，支持按名称筛选和分页。
getRepository
获取特定仓库的详细信息。
getPullRequests
获取仓库的拉取请求列表，可按状态筛选。
createPullRequest
创建新的拉取请求，支持指定源/目标分支、审查者和草稿状态。
getPullRequest
获取特定拉取请求的详细信息。
updatePullRequest
更新拉取请求，如标题、描述等。
getPullRequestActivity
获取拉取请求的活动日志。
approvePullRequest
批准拉取请求。
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
获取特定流水线步骤的日志。
安装接入
- 确保 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命令和所需环境变量。
claude_desktop_config.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"
}
}
}
}
选型与风险
不适合谁
- 需要对 Bitbucket 资源进行删除操作的用户（默认禁用删除工具）。
- 需要图形用户界面而非命令行或 AI 集成的用户。
- 没有 Bitbucket 账户或凭据的用户。
所需权限
- 需要 Bitbucket 应用密码或访问令牌。
- 根据操作需要至少“仓库：读取”权限。
- 对于流水线操作，需要“流水线：读取”权限。
- 对于写操作（如创建/更新 PR），需要“拉取请求：写入”权限。
风险与副作用
- 使用应用密码或令牌时，如果泄露可能导致未授权访问。
- 如果凭据权限过大，可能意外修改或删除数据（尽管默认禁用删除工具）。
- 错误配置可能暴露敏感信息（如错误的日志级别）。
常见排障
- 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 助手管理 Bitbucket 仓库和拉取请求，如列出仓库、查看 PR、创建 PR、审查和合并。
自动化工作流，如基于 PR 活动触发操作或运行流水线。
在对话界面中获取仓库信息、PR 评论和差异。
支持客户端
Cursor完整支持
Claude Desktop完整支持