Bitbucket云MCP服务器

一个基于MCP协议的服务器,允许AI助手通过自然语言对话读取和审查Bitbucket Cloud的拉取请求。

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

使用说明

比特桶云MCP服务器

一 MCP(模型上下文协议) 允许AI助手读取Bitbucket Cloud拉取请求的服务器。将Claude、Copilot或任何兼容MCP的客户端连接到您的Bitbucket Cloud工作区,并通过自然对话查看PR。

它能做什么?

工具 说明
get_bb_pull_request 检索拉取请求详细信息(标题、作者、状态、分支等)
get_bb_diff 获取拉取请求的全部差异

您可以与AI助手一起使用的示例提示:

“在我的应用程序仓库中总结拉取请求#42”

“审查PR#15的差异并提出改进建议”

“我们项目中开放PR的状态如何?”

快速开始

1.安装

git clone https://github.com/ttekun/bitbucket-cloud-mcp-server.git
cd bitbucket-cloud-mcp-server
npm install
npm run build

2.获取Bitbucket应用程序密码

  1. 首选 比特桶云 → 个人设置 → 应用密码
  2. 使用创建新的应用程序密码 存储库:读取 和 拉取请求:读取 权限

3.配置您的MCP客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bitbucket-cloud": {
      "command": "node",
      "args": ["/absolute/path/to/bitbucket-cloud-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_TOKEN": "your-app-password",
        "BITBUCKET_WORKSPACE": "your-workspace"
      }
    }
  }
}
VS Code (Copilot / Claude Code)

添加到您的VS代码设置或 .vscode/mcp.json:

{
  "mcpServers": {
    "bitbucket-cloud": {
      "command": "node",
      "args": ["/absolute/path/to/bitbucket-cloud-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_TOKEN": "your-app-password",
        "BITBUCKET_WORKSPACE": "your-workspace"
      }
    }
  }
}

环境变量

变量 必填 描述
BITBUCKET_TOKEN 是 Bitbucket云应用密码
BITBUCKET_WORKSPACE 否 默认工作区(可以根据请求覆盖)

刀具参数

这两个工具接受相同的参数:

参数 类型 必填 说明
workspace string 是* 比特桶工作区(*回退为 BITBUCKET_WORKSPACE ) 。
repo_slug string 是 存储库slug
pull_request_id number 是 拉取请求ID

发展

npm run dev        # Watch mode
npm test           # Run tests
npm run lint       # Lint
npm run inspector  # MCP Inspector (debug tool)

许可证

麻省理工学院