🚀 Atlassian Bitbucket MCP 服务器配置指南

本指南详细介绍了 Atlassian Bitbucket 的 MCP（机器学习平台）服务器的配置与使用方法。通过阅读本文，您将学会连接 AI 助手（如 Claude Desktop 或 Cursor AI）并与 Bitbucket 集成，从而更高效地进行代码管理和协作。

🚀 快速开始

本指南将引导您完成 Atlassian Bitbucket MCP 服务器的配置与使用，让您能够轻松连接 AI 助手并与 Bitbucket 集成。

✨ 主要特性

• 支持使用 npx 快速运行 MCP 服务器，无需安装。
• 可全局安装 MCP 工具，方便频繁使用。
• 提供多种身份验证方式，包括 Bitbucket 应用密码和 Atlassian API Token。
• 支持与 Claude Desktop 和 Cursor AI 等 AI 助手集成。
• 提供创建、审查和合并 Pull Request 等功能。

📦 安装指南

使用 npx 快速运行

无需安装即可直接使用 npx 运行 MCP 服务器：

# 列出所有工作区
npx -y @aashari/mcp-server-atlassian-bitbucket list-workspaces

# 获取仓库信息
npx -y @aashari/mcp-server-atlassian-bitbucket get-repository --workspace my-team --repository my-api

# 查看打开的 Pull Request
npx -y @aashari/mcp-server-atlassian-bitbucket list-pull-requests --workspace my-team --repository my-api --state OPEN

全局安装

如果需要频繁使用，可以将 MCP 工具全局安装到系统中：

# 安装命令
npm install -g @aashari/mcp-server-atlassian-bitbucket

# 验证安装版本
mcp-atlassian-bitbucket --version

环境变量配置

在运行 MCP 命令时，可以通过设置以下环境变量完成身份验证：

使用 Bitbucket 应用密码

# 登录信息
export ATLASSIAN_BITBUCKET_USERNAME=<YOUR_USERNAME>
export ATLASSIAN_BITBUCKET_APP_PASSWORD=<YOUR_APP_PASSWORD>

# 执行命令
mcp-atlassian-bitbucket list-workspaces

使用 Atlassian API Token

# 登录信息
export ATLASSIAN_SITE_NAME=bitbucket
export ATLASSIAN_USER_EMAIL=<YOUR_EMAIL>
export ATLASSIAN_API_TOKEN=<YOUR_API_TOKEN>

# 执行命令
mcp-atlassian-bitbucket list-workspaces

💻 使用示例

基础用法

配置 Claude Desktop

{
    "mcpServers": {
        "aashari/mcp-server-atlassian-bitbucket": {
            "command": "npx",
            "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
        }
    }
}

配置步骤如下：

1. 打开设置（齿轮图标）> 编辑配置。
2. 在 mcpServers 中添加上述内容。
3. 保存并重启 Claude Desktop。
4. 验证：点击工具图标（锤子），确认 Bitbucket 工具已列出。

配置 Cursor AI

配置步骤如下：

1. 打开命令面板 (Cmd+Shift+P 或 Ctrl+Shift+P) > Cursor Settings > MCP。
2. 点击 + 添加新 MCP 服务器。
3. 填写以下信息：
   • 名称：aashari/mcp-server-atlassian-bitbucket
   • 类型：command
   • 命令：npx -y @aashari/mcp-server-atlassian-bitbucket
4. 点击完成。

高级用法

创建 Pull Request

# 创建新 Pull Request
mcp-atlassian-bitbucket create-pull-request --from-ref=feature-branch --to-ref=main --title="feat: 新功能实现" --description="添加新功能的详细描述"

审查代码

# 查看指定仓库的所有 Pull Request
mcp-atlassian-bitbucket list-pull-requests --workspace=my-team --repository=my-api

合并 Pull Request

# 合并指定 Pull Request
mcp-atlassian-bitbucket merge-pull-request --workspace=my-team --repository=my-api --pullRequestId=123

📚 详细文档

更多关于 Bitbucket 和 MCP 的集成细节，请参考 官方文档。

如果有任何问题，欢迎随时联系支持团队。