比特桶服务器MCP
A. 模型上下文协议（MCP） 将AI助手连接到Bitbucket服务器/数据中心的服务器。查看拉取请求、管理存储库、搜索用户，并通过Claude和其他AI助手中的自然语言与您的Bitbucket实例进行交互。
🚀 快速开始
获取您的Bitbucket服务器凭据
- 登录您的Bitbucket服务器实例
- 首选 个人资料 → 管理帐户 → 个人访问令牌
- 点击 创建令牌
- 为其命名并选择适当的权限：
- 项目权限：阅读（或写评论） - 存储库权限：阅读（或写评论）
- 复制生成的令牌
- 注意您的Bitbucket服务器URL（例如。，
https://bitbucket.yourcompany.com)
配置
克劳德代码
使用Claude Code CLI添加服务器：
claude mcp add -s user \
bitbucket-server \
npx mcp-bitbucket-server@latest \
-e "BITBUCKET_URL=https://bitbucket.yourcompany.com" \
-e "BITBUCKET_TOKEN=your_personal_access_token"手动配置（任何MCP客户端）
或者，将此配置添加到MCP客户端的配置文件中：
{
"mcpServers": {
"bitbucket-server": {
"command": "npx",
"args": ["mcp-bitbucket-server@latest"],
"type": "stdio",
"env": {
"BITBUCKET_URL": "https://bitbucket.yourcompany.com",
"BITBUCKET_TOKEN": "your_personal_access_token"
}
}
}
}✨ 特性
- 👥 用户管理 -搜索用户并获取个人资料
- 📁 项目和存储库发现 -列出项目和存储库
- 🔍 拉取请求审查 -获取PR详细信息、更改、差异和活动
- 💬 聪明的评论 -在PR上添加一般、回复和内联评论
- 📊 PR收件箱 -查看您在所有项目中担任审阅者的所有PR
- 🎯 令牌优化 -优化响应以减少令牌使用
- 🔒 安全认证 -使用个人访问令牌
- 🛡️ 简单直接 -最小抽象，直接访问API
🛠️ 可用工具
服务器提供 11个MCP工具 对于Bitbucket服务器操作：
用户管理
bitbucket_get_user_profile-获取详细的用户信息bitbucket_get_all_users-列出并搜索所有用户
项目和存储库
bitbucket_list_projects-发现可用项目bitbucket_list_repositories-列出项目中的存储库
拉取请求操作
bitbucket_get_inbox_pull_requests-获取所有需要您审核的PRbitbucket_get_pull_request_changes-列出PR中所有更改的文件bitbucket_get_pull_request_file_diff-获取结构化的逐行差异bitbucket_get_pull_request_activities-获取公关评论、批准和活动bitbucket_add_pr_comment-添加常规、回复或内联评论
💡 查询示例
- *“显示我需要查看的所有拉取请求”*
- *“在PROJ存储库中获取拉取请求#123中的更改”*
- *“显示PR#456中src/main.ts的差异”*
- *“在src/app.ts的第42行添加注释，建议我们使用const”*
- *“列出DEV项目中的所有存储库”*
- *“查找名为John的用户”*
- *“PR#789最近有什么活动？”*
🏗️ 发展
来源
# Clone and setup
git clone https://github.com/evrimalacan/mcp-bitbucket-server.git
cd mcp-bitbucket-server
npm install
# Build
npm run build
# Development mode
npm run dev添加新工具
- 查看Bitbucket服务器Swagger文档(
BitbucketServerSwagger.json) - 在以下相应的域文件夹中创建新的工具文件
src/tools/ - 从域中导出
index.ts - 在中注册
src/tools/index.ts
看 CLAUDE.md 详细的开发指南。
🐛 故障排除
常见问题
“身份验证失败”
- 验证您的个人访问令牌是否正确
- 确保令牌具有适当的权限
“禁止访问”
- 检查您的Bitbucket用户是否有权限访问该资源
- 验证令牌权限是否包括所需的范围
“找不到资源”
- 确认项目密钥、存储库段块或PR ID是否正确
- 检查您是否有权访问指定的资源
📚 文档
- 开发指南 -详细的开发和贡献指南
- Bitbucket服务器REST API -API官方参考
- 模型上下文协议 -MCP规范
🤝 贡献
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 遵循中的开发指南
CLAUDE.md - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
🌟 支持
- 🐛 错误报告:
- 💡 功能请求:
- 📖 文档：参见 CLAUDE.md 全面指导
______________________________________________________________________
专为希望在Bitbucket服务器上获得人工智能帮助的开发人员而设计