---

name: bitbucket-automation description: "通过 Rube MCP (Composio) 自动化 Bitbucket 仓库、拉取请求、分支、问题和工作区管理。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Bitbucket 自动化

通过 Composio 的 Bitbucket 工具包自动化 Bitbucket 操作，包括仓库管理、拉取请求工作流、分支操作、问题跟踪和工作区管理。

前提条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 bitbucket 建立活跃的 Bitbucket 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥 - 只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用工具包 bitbucket 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Bitbucket OAuth
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 管理拉取请求

何时使用：用户想要创建、审查或检查拉取请求

工具序列：

1. BITBUCKET_LIST_WORKSPACES - 发现可访问的工作区 [前提]
2. BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE - 找到目标仓库 [前提]
3. BITBUCKET_LIST_BRANCHES - 验证源分支和目标分支存在 [前提]
4. BITBUCKET_CREATE_PULL_REQUEST - 创建带标题、源分支和可选审查者的新 PR [必需]
5. BITBUCKET_LIST_PULL_REQUESTS - 按状态筛选列出 PR（OPEN、MERGED、DECLINED）[可选]
6. BITBUCKET_GET_PULL_REQUEST - 按 ID 获取特定 PR 的完整详情 [可选]
7. BITBUCKET_GET_PULL_REQUEST_DIFF - 获取统一 diff 用于代码审查 [可选]
8. BITBUCKET_GET_PULL_REQUEST_DIFFSTAT - 获取更改文件及添加/删除行数 [可选]

关键参数：

• workspace：工作区 slug 或 UUID（所有操作必需）
• repo_slug：URL 友好的仓库名称
• source_branch：包含要合并更改的分支
• destination_branch：目标分支（省略时默认为仓库主分支）
• reviewers：带 uuid 字段的对象列表，用于分配审查者
• state：LIST_PULL_REQUESTS 的筛选器 - OPEN、MERGED 或 DECLINED
• max_chars：GET_PULL_REQUEST_DIFF 的截断限制，用于处理大型 diff

注意事项：

• reviewers 期望带 uuid 键的对象数组，不是用户名：[{"uuid": "{...}"}]
• UUID 格式必须包含花括号：{123e4567-e89b-12d3-a456-426614174000}
• 省略 destination_branch 时默认为仓库主分支，可能不是 main
• pull_request_id 在 GET/DIFF 操作中是整数，但作为 PR 列表的一部分返回
• 大型 diff 可能超出上下文；始终在 GET_PULL_REQUEST_DIFF 上设置 max_chars（如 50000）

2. 管理仓库和工作区

何时使用：用户想要列出、创建或删除仓库或浏览工作区

工具序列：

1. BITBUCKET_LIST_WORKSPACES - 列出所有可访问的工作区 [必需]
2. BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE - 使用可选 BBQL 筛选列出仓库 [必需]
3. BITBUCKET_CREATE_REPOSITORY - 创建带语言、隐私和项目设置的新仓库 [可选]
4. BITBUCKET_DELETE_REPOSITORY - 永久删除仓库（不可逆）[可选]
5. BITBUCKET_LIST_WORKSPACE_MEMBERS - 列出成员用于审查者分配或访问检查 [可选]

关键参数：

• workspace：工作区 slug（通过 LIST_WORKSPACES 查找）
• repo_slug：用于创建/删除的 URL 友好名称
• q：BBQL 查询筛选器（如 name~"api"、project.key="PROJ"、is_private=true）
• role：按用户角色筛选仓库：member、contributor、admin、owner
• sort：排序字段，可选 - 前缀表示降序（如 -updated_on）
• is_private：仓库可见性布尔值（默认为 true）
• project_key：Bitbucket 项目键；省略则使用工作区最旧的项目

注意事项：

• BITBUCKET_DELETE_REPOSITORY 不可逆且不影响 fork
• BBQL 字符串值必须用双引号括起：name~"my-repo" 而非 name~my-repo
• repository 不是有效的 BBQL 字段；使用 name 代替
• 默认分页为 10 条结果；显式设置 pagelen 以获取完整列表
• CREATE_REPOSITORY 默认为私有；设置 is_private: false 创建公开仓库

3. 管理问题

何时使用：用户想要创建、更新、列出或评论仓库问题

工具序列：

1. BITBUCKET_LIST_ISSUES - 使用状态、优先级、类型、受理人等可选筛选器列出问题 [必需]
2. BITBUCKET_CREATE_ISSUE - 创建带标题、内容、优先级和类型的新问题 [必需]
3. BITBUCKET_UPDATE_ISSUE - 修改问题属性