AI导哈

Bitbucket云MCP服务器

一个基于TypeScript的MCP服务器，用于与Bitbucket Cloud API交互，提供管理拉取请求和评论的工具。

  • by GauravJiandaniGJ
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 GauravJiandaniGJ/bitbucket-cloud-mcp-server

使用说明

bitbucket云mcp服务器

一个基于类型脚本的MCP（模型上下文协议）服务器，用于与Bitbucket Cloud API交互，提供管理拉取请求和评论的工具。

特性

工具 说明
bitbucket_list_prs 列出存储库的拉取请求
bitbucket_get_pr 获取单个PR的完整详细信息
bitbucket_get_pr_diff 获取PR的代码差异
bitbucket_list_pr_comments 列出PR上的所有评论
bitbucket_post_pr_comment 在PR上发布一般或内联评论

安装指南

先决条件

  • Node.js 18+
  • Bitbucket云账户
  • 已安装克劳德代码

步骤1：克隆和构建

git clone <this-repo-url>
cd bitbucket-cloud-mcp
npm install
npm run build

步骤2：创建一个Bitbucket API令牌

  1. 首选https://bitbucket.org/account/settings/api-tokens/
  2. 点击 创建API令牌
  3. 标签： Claude Code MCP
  4. 选择这些范围：
    • 拉取请求：读，写
    • 仓库：阅读
  5. 设置到期日（最多1年）
  6. 复制生成的令牌（您将无法再次看到它）

步骤3：配置Claude代码

将MCP服务器添加到项目的 .mcp.json （如果它不存在，请在项目根目录中创建它）：

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/absolute/path/to/bitbucket-cloud-mcp/dist/index.js"]
    }
  }
}

替换 /absolute/path/to/ 使用克隆仓库的实际路径。

BITBUCKET_WORKSPACE 是可选的-您可以在每次工具调用时指定它。

步骤4：重新启动Claude代码

重新启动Claude代码（或运行 /mcp 检查服务器状态）。Bitbucket工具现在应该可用了。

使用示例

配置后，您可以向Claude Code询问以下内容：

  • “在我的工作区/我的仓库中列出打开的PR”
  • “在我的工作区/仓库中显示PR#42的差异”
  • “对PR#42有什么评论？”
  • “在PR#42上发表评论说：看起来不错，但请在第55行添加错误处理”
  • “查看PR#42-阅读差异并将您的评论作为评论发布”

环境变量

变量 必填 描述
BITBUCKET_EMAIL 是 您的Atlassian帐户电子邮件
BITBUCKET_API_TOKEN 是 Bitbucket API令牌（带作用域）
BITBUCKET_WORKSPACE 否 默认工作区段塞
LOG_LEVEL 没有 debug, info （默认）， warn, error

多工作区支持

每个工具都接受一个可选 workspace 参数。如果没有提供，则退回到 BITBUCKET_WORKSPACE。这意味着您可以跨多个工作区工作，而无需重新配置。

故障排除

“身份验证失败” -检查您的电子邮件和API令牌。确保令牌具有所需的作用域（pullrequest读/写、存储库读取）。

“未找到” -验证工作区slug、repo slug和PR ID。工作区slugs是URL slug（例如。， my-team 从 bitbucket.org/my-team/).

“权限被拒绝” -您的API代币需求 pullrequest:write 发表评论的范围。

克劳德代码中未显示服务器 -快跑 /mcp 在克劳德代码中检查状态。确保路径 .mcp.json 是绝对和正确的。

相关 MCP