使用说明
比特桶MCP服务器
MCP(模型上下文协议)服务器通过stdio传输提供对Bitbucket服务器/数据中心的访问。使用个人访问令牌进行身份验证,并查询拉取请求、构建状态和存储库内容。
特性
- 📋 拉取请求:列表,获取详细信息,查看差异,列表提交
- 🔨 CI/CD:访问提交的构建状态
- 📁 代码:浏览文件、获取内容、查看差异
- ⚙️ 简易设置:互动
--installClaude代码和游标向导
安装
选项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
向导将:
- 检测已安装的代理(Claude Code、Cursor)
- 提示输入您的Bitbucket服务器URL
- 指导您生成个人访问令牌
- 验证凭据并保存配置
手动设置(如果向导未检测到您的代理)
添加到代理的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 ./...
许可证
麻省理工学院——见 许可证