Aashari MCP Server Atlassian Bitbucket

🚀 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 的集成細節，請參考 官方文檔。

如果有任何問題，歡迎隨時聯繫支持團隊。