Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP Server

site icon
2025.04.14 0
TypeScript版本控制AI 协作代码管理交流协作
Atlassian Bitbucket MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在作为 AI 助手(如 Anthropic's Claude、Cursor AI 或其他兼容 MCP 的客户端)与 Atlassian Bitbucket 实例之间的桥梁。它允许 AI 安全地实时访问和交互您的代码仓库、拉取请求和工作区。
View on GitHub

Overview

基本能力

产品定位

Atlassian Bitbucket MCP Server 是一个连接 AI 助手与 Bitbucket 版本控制系统的中间件,旨在增强 AI 在代码管理和协作中的能力。

核心功能

  • 实时访问 Bitbucket 数据:包括仓库、拉取请求和工作区信息。
  • 消除手动复制粘贴:AI 可以直接从 Bitbucket 获取信息,无需手动操作。
  • 增强 AI 能力:支持 AI 分析仓库、审查拉取请求、理解代码上下文等。
  • 安全性:通过 API 凭证控制访问,敏感操作限制在服务器内。

适用场景

  • AI 辅助代码审查
  • 自动化拉取请求管理
  • 代码仓库信息查询
  • 团队协作增强

工具列表

  1. List Workspaces (list-workspaces):列出可访问的 Bitbucket 工作区。
  2. Get Workspace (get-workspace):获取特定工作区的详细信息。
  3. List Repositories (list-repositories):列出工作区内的仓库。
  4. Get Repository (get-repository):获取特定仓库的详细信息。
  5. List Pull Requests (list-pull-requests):列出仓库中的拉取请求。
  6. Get Pull Request (get-pull-request):获取特定拉取请求的详细信息。
  7. Add Pull Request Comment (add-pr-comment):在拉取请求中添加评论。
  8. Create Pull Request (create-pull-request):创建新的拉取请求。

常见问题解答

  • 认证问题:确保使用正确的 API 凭证(Bitbucket App Password 或 Atlassian API Token)。
  • 权限问题:检查凭证是否具有足够的权限(如 Read 权限)。
  • 配置问题:确保配置文件或环境变量设置正确。

使用教程

使用依赖

  • Node.js 和 npm:需安装 Node.js(包含 npm)。
  • Bitbucket 账户:需有活跃的 Bitbucket Cloud 账户。

安装教程

  1. 安装 Node.js:从 nodejs.org 下载并安装。
  2. 设置认证
  3. Bitbucket App Passwordbash ATLASSIAN_BITBUCKET_USERNAME="<YOUR_USERNAME>" \ ATLASSIAN_BITBUCKET_APP_PASSWORD="<YOUR_APP_PASSWORD>" \ npx -y @aashari/mcp-server-atlassian-bitbucket
  4. Atlassian API Tokenbash ATLASSIAN_SITE_NAME="bitbucket" \ ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" \ ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>" \ npx -y @aashari/mcp-server-atlassian-bitbucket
  5. 全局安装(可选)bash npm install -g @aashari/mcp-server-atlassian-bitbucket

调试方式

  1. 验证安装bash mcp-atlassian-bitbucket --version
  2. 测试工具bash mcp-atlassian-bitbucket list-workspaces
  3. 检查日志:查看运行时的输出日志以排查问题。

许可证

该项目遵循 ISC 开源许可条款。