Bitbucket Server MCP

社区

面向 Bitbucket Server 拉取请求管理的 MCP 服务器

分类: 开发工具第 176 / 438
Stars: ★ 69 热门
传输方式: stdio（本地进程）
运行环境: Node.js 16+
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 8 天前
工具数: 27

56FMRS · C

该服务器围绕 Bitbucket Server 拉取请求全流程提供了较为完整的工具集，涵盖项目/仓库发现、PR 创建到合并、评论与批量审阅、代码搜索与文件浏览，并支持只读模式和自定义请求头以适配企业网络环境；使用前需妥善保护认证凭据，并留意非只读模式下写操作的不可逆性。

最强项 · 文档质量 16/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

9/20

维护活跃度

11/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 7/20: 仅能获取 README 文本，未提供服务器清单缓存，也未看到任何 CI 工作流或已提交测试文件可验证 MCP 初始化/工具列表握手是否真实可复现。README 声明了 20+ 个工具及详细参数，但这些描述是否与实际代码行为一致无法从现有材料核实。按静态评审规则，缺少可验证的执行证据（CI+测试）时可靠性不得超过 12 分，此处进一步下调因完全没有任何执行或测试证据佐证，仅存在文档层面的承诺。
安全与权限 9/20: 认证支持 Token 或用户名/密码，通过环境变量传入，属于常见做法，文档中未出现真实凭证泄露。但默认配置为完整读写模式，需用户主动设置 BITBUCKET_READ_ONLY=true 才能限制权限；merge_pull_request、decline_pull_request、delete_branch、delete_comment 等具有不可逆影响的操作在文档中没有描述任何二次确认机制，权限边界主要依赖调用方（LLM/用户）自律而非服务端强制。BITBUCKET_CUSTOM_HEADERS 允许附加任意请求头，暴露面尚可控。未达到红线（无恶意代码、无凭证窃取、无虚假身份），但权限最小化与危险操作确认机制不完整。
维护活跃度 11/20: 仓库使用 Apache-2.0 许可证，非归档状态，README 内的“New Features”章节显示近期持续新增功能（如自定义头、PR 发现、分支管理等），并引用了具体 issue 号（#14），说明存在一定的社区反馈响应。但缺少版本号、CHANGELOG、发布节奏、贡献指南或安全响应渠道的直接证据，无法核实提交频率或维护者身份的稳定性，只能判断为“活跃但治理信息不全”。
文档质量 16/20: README 结构分层清晰：安装（Smithery 与手动）、构建、每个工具的用途/参数/使用场景、大量命令行示例、环境变量说明、只读模式的工具白名单/黑名单、日志路径优先级、自定义请求头格式均有说明。不足之处在于缺少专门的故障排查（troubleshooting）章节、API 速率限制、错误码含义及跨平台兼容性的具体说明，也没有关于工具调用失败时行为的描述。
安装易用性 13/20: 安装路径明确：`npm install` → `npm run build` → 在 MCP 客户端配置文件中手动填写 node 路径与环境变量，另提供 Smithery 一键安装选项，覆盖了主流客户端配置示例。但需要手动构建并手动填写绝对路径，属于半手动流程，且没有仓库内 CI/测试文件能证明构建/运行链路真实可用，按静态评审规则该维度上限为 15 分，因缺少可验证执行证据不能给满分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用自托管 Bitbucket Server/Data Center 的团队，希望通过对话式界面管理 PR 工作流
需要在 CI/CD 或代理环境中以只读方式安全访问 Bitbucket 数据的场景
希望在零信任网络架构下通过自定义请求头访问 Bitbucket 的组织

不适合谁

使用 Bitbucket Cloud（bitbucket.org）而非 Bitbucket Server/Data Center 的用户，该服务器面向 Server API
不希望以 Node.js 进程方式在本地运行 MCP 服务器的用户

所需权限

需要 Bitbucket Server 的个人访问令牌，或用户名/密码基本认证凭据
凭据权限决定可执行的操作范围，写操作（创建/合并/评论/删除分支等）需要相应的仓库写权限
可选的自定义 HTTP 请求头会随所有请求发送，需妥善管理其中可能包含的令牌

风险与副作用

认证令牌或密码以环境变量明文形式配置，需注意存储和传输安全
非只读模式下模型可直接执行合并、拒绝、删除分支、删除评论等不可逆或影响协作的操作，存在误操作风险
日志文件默认写入本地磁盘（`~/.bitbucket-server-mcp/bitbucket.log`），可能包含敏感操作记录

安装接入

准备工作

运行环境：Node.js 16+

BITBUCKET_URL 必填必填，你的 Bitbucket Server 实例的基础 URL。

BITBUCKET_TOKEN 可选密钥在 Bitbucket Server 中生成的个人访问令牌，与用户名/密码二选一。

BITBUCKET_PASSWORD 可选密钥 Bitbucket 密码，与 BITBUCKET_USERNAME 搭配使用。

其他可选配置项（6 个）

BITBUCKET_USERNAME 可选 Bitbucket 用户名，与 BITBUCKET_PASSWORD 搭配作为基本认证方式。

BITBUCKET_DEFAULT_PROJECT 可选可选的默认项目 key，未在工具调用中指定 project 时使用。

BITBUCKET_DIFF_MAX_LINES_PER_FILE 可选可选，diff 中每个文件默认显示的最大行数，防止大文件刷屏。

BITBUCKET_LOG_PATH 可选可选，自定义日志文件路径，默认为 ~/.bitbucket-server-mcp/bitbucket.log。

BITBUCKET_READ_ONLY 可选设为 true 启用只读模式，禁用所有写操作。

BITBUCKET_CUSTOM_HEADERS 可选可选，逗号分隔的自定义 HTTP 请求头，适用于零信任令牌或代理场景。

确保已安装 Node.js >= 16。
可选：通过 Smithery 一键安装（npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude），或手动安装：npm install 后执行 npm run build。
在 MCP 客户端配置文件中添加服务器条目，设置 command 为 node，args 指向构建产物 build/index.js。
配置环境变量：BITBUCKET_URL（必填），以及 BITBUCKET_TOKEN 或 BITBUCKET_USERNAME/BITBUCKET_PASSWORD 二选一用于认证；可选设置 BITBUCKET_DEFAULT_PROJECT、BITBUCKET_READ_ONLY、BITBUCKET_CUSTOM_HEADERS、BITBUCKET_LOG_PATH、BITBUCKET_DIFF_MAX_LINES_PER_FILE。
重启客户端使配置生效。

claude_desktop_config.json

{"mcpServers":{"bitbucket":{"command":"node","args":["/path/to/bitbucket-server/build/index.js"],"env":{"BITBUCKET_URL":"https://your-bitbucket-server.com","BITBUCKET_TOKEN":"your-access-token","BITBUCKET_DEFAULT_PROJECT":"your-default-project"}}}}

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

.vscode/mcp.json

{
  "servers": {
    "bitbucket": {
      "command": "node",
      "args": [
        "/path/to/bitbucket-server/build/index.js"
      ],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token",
        "BITBUCKET_DEFAULT_PROJECT": "your-default-project"
      }
    }
  }
}

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

Terminal

claude mcp add bitbucket -e BITBUCKET_URL=https://your-bitbucket-server.com -e BITBUCKET_TOKEN=your-access-token -e BITBUCKET_DEFAULT_PROJECT=your-default-project -- node /path/to/bitbucket-server/build/index.js

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

生成并校验客户端配置

验证是否装好

安装并构建后，在客户端的工具列表中应能看到 list_projects、get_pull_request 等工具；运行 list_projects，若能返回你 Bitbucket 实例上的项目列表，即证明连接成功。

常见排障

确认 `BITBUCKET_URL` 及认证信息（Token 或用户名/密码）配置正确且账号有相应仓库权限
若写操作被拒绝，检查是否误设置了 `BITBUCKET_READ_ONLY=true`
若某些操作提示项目未指定，检查是否需要设置 `BITBUCKET_DEFAULT_PROJECT` 或在调用时显式传入 `project` 参数
查看日志文件（默认 `~/.bitbucket-server-mcp/bitbucket.log`，或 `BITBUCKET_LOG_PATH` 指定路径）定位具体错误
确认已执行 `npm install` 与 `npm run build`，且客户端配置中的路径指向正确的 `build/index.js`

试试这样问

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

列出我的 Bitbucket 服务器上所有可访问的项目
在 MYPROJECT 的 my-repo 仓库里搜索使用 getUserData 函数的代码
查看 my-repo 仓库中 ID 为 123 的 pull request 的 diff，然后批准并合并它
列出 my-repo 仓库中作者为 john.doe 的所有开启状态的 pull request

工具能力 27

list_projects 只读

列出所有可访问的 Bitbucket 项目及其详情，便于发现项目和获取正确的项目 key。

list_repositories 只读

浏览指定项目或所有可访问项目下的仓库，返回克隆地址等元数据。

create_pull_request 写入

创建新的拉取请求，支持指定源/目标分支、审阅者，并可用于跨仓库（fork）场景。

update_pull_request 写入

以读取-修改-写入的方式安全更新拉取请求的标题、描述或审阅者，未修改字段保持不变。

get_pull_request 只读

获取拉取请求的详细信息，包括状态、审阅者、提交等元数据。

merge_pull_request 写入

合并已批准的拉取请求，支持合并提交、压缩合并或快进合并策略。

decline_pull_request 写入

拒绝不应合并的拉取请求，并可附带说明原因。

add_comment 写入

在拉取请求中添加评论，支持 Markdown 和多级回复，可发布为公开或待发布草稿。

展开其余 19 个工具

add_comment_inline 写入

在拉取请求的代码差异中添加行内评论。

get_diff 只读

获取拉取请求的代码差异，支持设置上下文行数及单文件最大显示行数以处理大文件。

get_reviews 只读

获取拉取请求的审阅历史、批准状态及审阅者反馈。

get_activities 只读

获取拉取请求的完整活动时间线，包括评论、审阅、提交等事件。

get_comments 只读

从拉取请求活动中筛选出评论内容，便于专注于讨论内容。

search 只读

跨仓库搜索代码和文件内容，支持按项目/仓库过滤，仅在仓库默认分支上生效。

get_file_content 只读

读取仓库中指定文件的内容，支持分页处理大文件。

browse_repository 只读

浏览仓库的目录结构，探索项目组织方式。

list_pull_requests 只读

按状态、作者或方向筛选并列出仓库中的拉取请求。

list_branches 只读

列出仓库分支，识别默认分支并显示各分支最新提交信息。

list_commits 只读

列出仓库提交历史，支持按分支和作者过滤。

delete_branch 破坏性

删除仓库中的分支，内置防止删除默认分支的安全检查。

approve_pull_request 写入

以当前认证用户身份批准拉取请求。

unapprove_pull_request 写入

撤销对拉取请求的批准。

edit_comment 写入

编辑拉取请求中已有评论的文本内容，需提供评论版本号以进行乐观锁校验。

delete_comment 破坏性

删除拉取请求中的评论，需提供评论版本号以进行乐观锁校验。

publish_review 写入

一次性发布所有待发布的草稿评论，并可设置审阅状态（批准/需要修改）及总体评论。

get_code_insights 只读

获取拉取请求的 Code Insights 报告（如 SonarQube、安全扫描等）及其注释。

get_dashboard_pull_requests 只读

跨所有仓库列出当前认证用户相关的拉取请求，如待审阅、本人发起或参与的 PR。

使用场景

在 AI 助手中直接创建、审阅、批准和合并 Bitbucket Server 拉取请求

跨项目搜索代码、浏览仓库结构并读取文件内容

查看拉取请求的差异、评论、审阅状态与 CI/CD 代码洞察结果

管理分支（列出、过滤、删除已合并分支）和查看提交历史

支持客户端

Claude Desktop

VS Code

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

详细介绍

Bitbucket Server MCP 是一个基于 Node.js 的 MCP 服务器，通过 Bitbucket Server REST API 提供项目与仓库浏览、拉取请求全生命周期管理（创建、更新、审批、合并、拒绝）、代码搜索、文件读取、分支与提交历史查看、评论管理以及 CI/CD 代码洞察（如 SonarQube）等能力。支持通过环境变量配置默认项目、只读模式和自定义 HTTP 请求头（适用于零信任令牌或代理场景）。