适合谁
- 希望使用 AI 辅助代码审查和仓库管理的开发者。
- 需要快速了解项目状态和拉取请求活动的团队负责人。
- 希望自动化仓库工作流和分支管理的 DevOps 工程师。
- 任何想用自然语言与 Bitbucket 交互的人。
A
56FMRS · C
该 MCP 服务器将 AI 助手与 Bitbucket Cloud 连接起来，提供对工作区、仓库和拉取请求的全面操作能力。它通过 6 个通用 REST 工具提供灵活性，支持 JMESPath 过滤和 TOON 格式以减少令牌消耗。安装配置简单，支持多种 AI 客户端。注意：仅支持 Bitbucket Cloud，需要适当的凭据和权限，存在令牌消耗和误操作风险。总体而言，对于希望将 AI 集成到 Bitbucket 工作流的开发者来说，这是一个功能丰富且实用的工具。
这是一个用于 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 月弃用）。
工具能力
bb_get
对任何 Bitbucket API 端点执行 GET 请求，用于读取数据（如列出仓库、获取 PR 详情）。
bb_post
对任何端点执行 POST 请求，用于创建资源（如创建 PR、添加评论）。
bb_put
对任何端点执行 PUT 请求，用于替换资源（如更新仓库描述）。
bb_patch
对任何端点执行 PATCH 请求，用于部分更新资源（如更新 PR 标题）。
bb_delete
对任何端点执行 DELETE 请求，用于删除资源（如删除分支）。
bb_clone
将仓库本地克隆到指定目录。
安装接入
- 获取 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"
}
}
}
}
选型与风险
不适合谁
- 使用 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 运行最新版本可能引入不可预测的更改。建议锁定版本。
常见排障
- 认证失败或 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 关于代码的问题：'我的主仓库最新提交是什么？'
获取 PR 洞察：'显示所有需要审查的开放拉取请求。'
搜索代码库：'查找所有使用认证函数的 JavaScript 文件。'
审查代码更改：'比较我的功能分支与主分支的差异。'
管理拉取请求：'为我的新功能分支创建 PR。'
自动化工作流：'在 PR #123 中添加测试结果的评论。'
支持客户端
Claude Desktop完整支持
Cursor AI完整支持
Continue.dev完整支持
Cline完整支持