Bitbucket API 集成服务

比特桶MCP服务器

FastMCP服务器，用于全面的Bitbucket Cloud API集成。直接从Claude管理拉取请求、存储库、分支、提交、管道、问题、Webhook、代码片段等。

特性

• 用户和帐户：获取当前用户信息、用户配置文件和存储库权限
• 库管理：列出、创建、更新、删除和分叉存储库
• 分支和标签管理：创建/删除分支和标记，查看分支模型
• 提交和构建状态：列出提交、查看差异、管理构建状态
• 拉取请求生命周期：创建、更新、合并和拒绝PR
• 代码审查：批准、请求更改、添加/删除审阅者
• 评论：添加、阅读、回复和删除注释（包括内联代码注释）
• 差异与代码：查看差异、文件更改、提交和文件内容
• 合并状态：检查PR是否可以合并，查看冲突和阻止
• 管道（CI/CD）：列出、触发、停止管道；查看步骤和日志；管理变量
• 工作区和项目：列出工作区、管理项目、搜索代码
• 问题：创建、更新、列出问题；管理问题评论
• 网络钩子：创建、列出和删除存储库和工作区Webhook
• 代码片段：创建、列出、获取和删除代码段

安装

来自PyPI（推荐）

pip install bitbucket-mcp

或者直接使用uvx运行（无需安装）：

uvx bitbucket-mcp

获取API令牌

1. 首选 大西洋API代币
2. 点击 创建API令牌
3. 为其命名（例如，“Bitbucket MCP”）
4. 复制生成的令牌

配置

选项1：交互式设置（推荐）

使用 setup_bitbucket 工具：

setup_bitbucket(
    workspace="your-workspace",
    username="your-email@example.com",
    api_token="your-api-token"
)

这将凭据安全地存储在 ~/.bitbucket-mcp/config.json 拥有600个权限。

选项2：环境变量

export BITBUCKET_API_TOKEN="your-api-token"
export BITBUCKET_USERNAME="your-email@example.com"
export BITBUCKET_WORKSPACE="your-workspace"  # optional default

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "bitbucket": {
      "command": "uvx",
      "args": ["bitbucket-mcp"]
    }
  }
}

或者，如果安装了pip：

{
  "mcpServers": {
    "bitbucket": {
      "command": "bitbucket-mcp"
    }
  }
}

可用工具（共77个）

配置（2个工具）

用户和帐户（3个工具）

存储库管理（7个工具）

分支和标签管理（7个工具）

提交和构建状态（8个工具）

拉取请求（20个工具）

管道/CI/CD（8个工具）

工作区和项目（10个工具）

问题（6个工具）

Webhooks（4个工具）

片段（4个工具）

Claude使用示例

1. 首次设置：

   “使用我的工作区'mycompany'、用户名'设置Bitbucket”me@example.com'，和API令牌“abc123'”

2. 列出存储库：

   “显示我工作区中的所有存储库”

3. 创建PR：

   “在我的仓库中从功能/登录到主目录创建一个标题为“添加用户登录”的PR”

4. 审查PR：

   “批准我的回购中的PR#42”

5. 检查合并状态：

   “PR#42可以合并吗？是否存在任何冲突？”

6. 合并PR：

   “挤压合并PR#42并删除源分支”

7. 管道作业：

   “在主分支上为我的回购触发管道” “显示上次管道运行的日志”

8. 分行管理：

   “在我的仓库中从main创建一个分支'feature/new-api'” “列出我的仓库中的所有标签”

9. 问题跟踪：

   “在我的仓库中创建一个名为“手机登录失败”的错误问题” “显示我的回购中的所有未结问题”

10. 代码搜索：

    “在我的工作区中的所有存储库中搜索'TODO'”

安全

• 凭据存储在 ~/.bitbucket-mcp/config.json 拥有600个权限（仅限所有者访问）
• API令牌从不记录或暴露在错误消息中
• CI/CD场景支持环境变量

许可证

MIT许可证-请参阅 许可证 了解详情。