Bitbucket MCP服务器

Bitbucket MCP服务器是一款通过标准输入输出传输协议提供Bitbucket Server/Data Center访问的工具,支持通过个人访问令牌进行身份验证,查询拉取请求、构建状态和仓库内容。

  • by ilyalaletin
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 ilyalaletin/bitbucket-mcp

使用说明

比特桶MCP服务器

MCP(模型上下文协议)服务器通过stdio传输提供对Bitbucket服务器/数据中心的访问。使用个人访问令牌进行身份验证,并查询拉取请求、构建状态和存储库内容。

特性

  • 📋 拉取请求:列表,获取详细信息,查看差异,列表提交
  • 🔨 CI/CD:访问提交的构建状态
  • 📁 代码:浏览文件、获取内容、查看差异
  • ⚙️ 简易设置:互动 --install Claude代码和游标向导

安装

选项1:使用go install(推荐)

go install github.com/ilyalaletin/bitbucket-mcp/cmd/bitbucket-mcp@latest

或特定版本:

go install github.com/ilyalaletin/bitbucket-mcp/cmd/bitbucket-mcp@v0.1

选项2:下载二进制文件

下载自 发布:

  • Linux: bitbucket-mcp-linux-amd64 或 bitbucket-mcp-linux-arm64
  • macOS: bitbucket-mcp-darwin-amd64 或 bitbucket-mcp-darwin-arm64
# Extract and move to PATH
chmod +x bitbucket-mcp-*
mv bitbucket-mcp-* /usr/local/bin/bitbucket-mcp

选项3:从源代码构建

git clone https://github.com/ilyalaletin/bitbucket-mcp.git
cd bitbucket-mcp
go build ./cmd/bitbucket-mcp/
mv bitbucket-mcp /usr/local/bin/  # optional

使用安装向导进行配置

./bitbucket-mcp --install
# or
./bitbucket-mcp -i

向导将:

  1. 检测已安装的代理(Claude Code、Cursor)
  2. 提示输入您的Bitbucket服务器URL
  3. 指导您生成个人访问令牌
  4. 验证凭据并保存配置

手动设置(如果向导未检测到您的代理)

添加到代理的MCP配置中:

克劳德代码 (~/.claude.json):

{
  "mcpServers": {
    "bitbucket": {
      "command": "bitbucket-mcp",
      "env": {
        "BITBUCKET_URL": "https://bitbucket.example.com",
        "BITBUCKET_TOKEN": "your-personal-access-token"
      }
    }
  }
}

光标 (~/.cursor/mcp.json):

{
  "mcpServers": {
    "bitbucket": {
      "command": "bitbucket-mcp",
      "env": {
        "BITBUCKET_URL": "https://bitbucket.example.com",
        "BITBUCKET_TOKEN": "your-personal-access-token"
      }
    }
  }
}

重新启动代理

重新启动Claude Code或Cursor以激活MCP服务器。

用法

安装后,让Claude/Cursor执行以下操作:

  • “列出项目KEY中打开的PR”
  • “显示项目KEY/repo中PR#123的差异”
  • “获取提交abc123def的生成状态”
  • “列出仓库根目录中的文件”

MCP工具

工具 说明
list_prs 列出拉取请求(按仓库或角色)
get_pr 获取PR详细信息、描述、审阅者
get_pr_diff PR完全不同
get_pr_commits PR中的列表提交
get_build_status 为提交构建状态
list_files 列出存储库路径中的文件/目录
get_file_content 读取文件内容
get_diff 两个参考文献之间的差异

发展

构建

go build ./cmd/bitbucket-mcp/

测试

go test ./...

棉绒

go vet ./...

许可证

麻省理工学院——见 许可证

支持