Atlassian Bitbucket MCP Server

社区

将 AI 连接到您的 Bitbucket 仓库

分类: 开发工具第 176 / 438
Stars: ★ 163 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 需要 API Key / 凭据
最近提交: 7 个月前 ⚠
工具数: 6

56FMRS · C

该 MCP 服务器将 AI 助手与 Bitbucket Cloud 连接起来，提供对工作区、仓库和拉取请求的全面操作能力。它通过 6 个通用 REST 工具提供灵活性，支持 JMESPath 过滤和 TOON 格式以减少令牌消耗。安装配置简单，支持多种 AI 客户端。注意：仅支持 Bitbucket Cloud，需要适当的凭据和权限，存在令牌消耗和误操作风险。总体而言，对于希望将 AI 集成到 Bitbucket 工作流的开发者来说，这是一个功能丰富且实用的工具。

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

可靠性

8/20

安全与权限

10/20

维护活跃度

10/20

文档质量

16/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 源代码中缺乏测试和CI配置，无法验证服务器是否能可靠地完成初始化握手和工具列表。尽管README描述功能丰富，但静态审查无法确认实际行为，因此分数上限为12，考虑到代码结构清晰且错误处理可见，给予8分。
安全与权限 10/20: 凭证通过环境变量传递，避免了硬编码，但未发现显式的权限最小化或敏感操作的确认机制。没有出现恶意行为，但安全设计不够完整，因此评分偏低，但未触发红线。
维护活跃度 10/20: 仓库活跃，有160星和最近更新，但许可证未知，且没有明确的安全响应渠道。依赖更新情况不明确，因此扣分。
文档质量 16/20: 文档详尽，包括安装、认证、参数、示例和故障排除，但缺少代码级证据支持，且部分高级功能（如TOON格式）可能未完全实现或验证，因此未给满分。
安装易用性 12/20: 提供了清晰的安装步骤和客户端配置示例，但依赖npx和全局安装，可能有网络和环境问题，且未提供离线或本地运行的具体验证，因此分数受限。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望使用 AI 辅助代码审查和仓库管理的开发者。
需要快速了解项目状态和拉取请求活动的团队负责人。
希望自动化仓库工作流和分支管理的 DevOps 工程师。
任何想用自然语言与 Bitbucket 交互的人。

不适合谁

使用 Bitbucket Server 或 Data Center 的用户（仅支持 Bitbucket Cloud）。
需要实时推送或持续连接的用户（仅支持请求-响应模式）。
需要超出 Bitbucket REST API 2.0 范围的复杂操作的用户。
不打算使用 JSON 或 TOON 输出的用户（默认输出 TOON，可覆盖为 JSON）。

所需权限

需要 Bitbucket 认证凭据：Atlassian API 令牌（推荐）或应用密码（旧）。
需要适当的权限范围：repository 和 workspace（只读），添加 pullrequest 以管理 PR。
对于应用密码，需要 Workspaces: Read, Repositories: Read（如需写操作则添加 Write），Pull Requests: Read（如需管理则添加 Write）。
如果需要克隆仓库，则需要在目标系统上有本地文件系统写权限。

风险与副作用

凭据泄露：环境变量中存储的令牌或密码可能被未经授权访问。确保妥善保管并定期轮换。
数据访问：服务器可以访问您授予权限的所有 Bitbucket 数据，包括私有仓库。仅在信任的环境中运行。
令牌消耗：未加过滤的 API 响应可能很大，导致高令牌费用。建议始终使用 JMESPath 过滤和分页。
错误操作：AI 可能通过 POST/PUT/PATCH/DELETE 工具执行意外操作（如合并 PR、删除分支）。建议先在只读模式下测试。
依赖风险：使用 npx 运行最新版本可能引入不可预测的更改。建议锁定版本。

安装接入

准备工作

运行环境：Node.js 18+

ATLASSIAN_USER_EMAIL 必填 Atlassian 账户邮箱，与 API Token 配对使用，在 id.atlassian.com 获取。

ATLASSIAN_API_TOKEN 必填密钥带 scope 的 Atlassian API Token（以 ATATT 开头），在 id.atlassian.com/manage-profile/security/api-tokens 创建，需 repository、workspace（及 pullrequest）scope。

ATLASSIAN_BITBUCKET_APP_PASSWORD 可选密钥 Bitbucket App Password（旧方式，2026 年 6 月起弃用），在 bitbucket.org/account/settings/app-passwords 创建。

其他可选配置项（3 个）

ATLASSIAN_BITBUCKET_USERNAME 可选 Bitbucket 用户名，仅旧版 App Password 方式使用。

BITBUCKET_DEFAULT_WORKSPACE 可选可选的默认工作区 slug，用于省略 workspace 参数时。

DEBUG 可选设为 true 可输出详细日志，便于排查问题。

获取 Bitbucket 凭据：推荐使用 Atlassian API 令牌（在 https://id.atlassian.com/manage-profile/security/api-tokens 创建，选择 Bitbucket 产品，配置作用域：repository, workspace（如需 PR 管理添加 pullrequest）），或使用应用密码（旧方法，2026 年 6 月弃用）。
设置环境变量：ATLASSIAN_USER_EMAIL 和 ATLASSIAN_API_TOKEN（推荐）或 ATLASSIAN_BITBUCKET_USERNAME 和 ATLASSIAN_BITBUCKET_APP_PASSWORD（旧方法）。
通过 npx 直接运行：npx -y @aashari/mcp-server-atlassian-bitbucket get --path "/workspaces"。
配置 AI 客户端（如 Claude Desktop）：在 claude_desktop_config.json 中添加 MCP 服务器配置，使用 npx 命令和上述环境变量。
重启客户端即可使用。

claude_desktop_config.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

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

.vscode/mcp.json

{
  "servers": {
    "bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-bitbucket"
      ],
      "env": {
        "ATLASSIAN_USER_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

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

Terminal

claude mcp add bitbucket -e [email protected] -e ATLASSIAN_API_TOKEN=your_scoped_api_token -- npx -y @aashari/mcp-server-atlassian-bitbucket

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

生成并校验客户端配置

验证是否装好

在 Claude Desktop 配置中添加该服务器并重启，工具列表中应出现 bb_get、bb_post、bb_put、bb_patch、bb_delete、bb_clone 六个工具；或在终端运行 npx -y @aashari/mcp-server-atlassian-bitbucket get --path "/workspaces" 验证凭据。

常见排障

认证失败或 403：检查令牌是否有效且具有正确作用域（repository, workspace, pullrequest）。验证环境变量名称是否正确（ATLASSIAN_USER_EMAIL 和 ATLASSIAN_API_TOKEN 或 ATLASSIAN_BITBUCKET_USERNAME 和 ATLASSIAN_BITBUCKET_APP_PASSWORD）。
资源未找到或 404：确保路径大小写正确，使用工作区 slug 而不是显示名称。先用 CLI 命令列出工作区以确认 slug。
Claude Desktop 不显示服务器：检查配置文件 JSON 语法，重启 Claude Desktop，查看日志（macOS: ~/Library/Logs/Claude/mcp*.log）。
工具不工作：启用 DEBUG=true 查看详细日志，先用 CLI 测试隔离问题。
npx 执行问题：确保 Node.js 版本 >= 18，并检查网络连接。

试试这样问

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

列出我工作区里的所有仓库
显示所有需要评审的开放 pull request
在 PR #123 上添加评论，说明测试已通过
比较我的 feature 分支和 main 分支的差异

工具能力 6

bb_get 只读

对任何 Bitbucket API 端点执行 GET 请求，用于读取数据（如列出仓库、获取 PR 详情）。

bb_post 写入

对任何端点执行 POST 请求，用于创建资源（如创建 PR、添加评论）。

bb_put 写入

对任何端点执行 PUT 请求，用于替换资源（如更新仓库描述）。

bb_patch 写入

对任何端点执行 PATCH 请求，用于部分更新资源（如更新 PR 标题）。

bb_delete 破坏性

对任何端点执行 DELETE 请求，用于删除资源（如删除分支）。

bb_clone 写入

将仓库本地克隆到指定目录。

使用场景

询问 AI 关于代码的问题：'我的主仓库最新提交是什么？'

获取 PR 洞察：'显示所有需要审查的开放拉取请求。'

搜索代码库：'查找所有使用认证函数的 JavaScript 文件。'

审查代码更改：'比较我的功能分支与主分支的差异。'

管理拉取请求：'为我的新功能分支创建 PR。'

自动化工作流：'在 PR #123 中添加测试结果的评论。'

支持客户端

Claude Desktop

Cursor AI

Continue

Cline

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

详细介绍

这是一个用于 Atlassian Bitbucket 的 Node.js/TypeScript MCP 服务器。它通过标准 MCP 接口，让 AI 系统（如 Claude、Cursor）能够直接与 Bitbucket 工作区、仓库和拉取请求交互。提供 6 个通用工具（bb_get、bb_post、bb_put、bb_patch、bb_delete、bb_clone），支持对任何 Bitbucket Cloud REST API 2.0 端点进行读取、创建、更新、删除和克隆操作。支持 JMESPath 过滤和 TOON 输出格式，以减少令牌消耗。需要 Node.js 18.0.0 或更高版本，以及 Bitbucket Cloud 账号（不支持 Bitbucket Server/Data Center）。认证方式推荐使用 Atlassian 范围内的 API 令牌（以 ATATT 开头），也可使用旧的应用程序密码（将于 2026 年 6 月弃用）。