Bitbucket Server MCP Server

🚀 Bitbucket 服務器 MCP

MCP（模型上下文協議）服務器用於管理 Bitbucket 服務器上的拉取請求，它提供了與 Bitbucket 服務器 API 通過 MCP 協議交互的工具和資源。

🚀 快速開始

本項目是用於管理 Bitbucket 服務器上拉取請求的 MCP 服務器。在使用前，你需要確保滿足一定的要求，並完成安裝、構建等操作。

✨ 主要特性

該服務器提供了以下用於 Bitbucket 服務器集成的工具：

• create_pull_request：創建新的拉取請求。
• get_pull_request：獲取特定拉取請求的詳細信息。
• merge_pull_request：合併拉取請求。
• decline_pull_request：拒絕拉取請求。
• add_comment：在拉取請求中添加評論。
• get_diff：獲取拉取請求的差異。

📦 安裝指南

要求

• Node.js >= 16

安裝方式

通過 Smithery 安裝

要自動安裝 Bitbucket 服務器以供 Claude 桌面使用，請通過 Smithery：

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

手動安裝

npm install

構建

npm run build

💻 使用示例

基礎用法

以下是使用 create_pull_request 創建拉取請求的示例：

# 假設環境變量已正確配置
# 這裡只是示意，實際使用時根據情況修改參數
# 創建一個拉取請求，指定項目、倉庫、標題等信息
# 注意：project 若未指定，會使用默認項目密鑰（如果已設置）
# 這裡的參數僅為示例，你需要根據實際情況修改
# 例如，將 repository 替換為你實際的倉庫別名
# 將 title 替換為你想要的 PR 標題等
# 調用 create_pull_request 方法創建拉取請求
# 這裡使用了默認的項目密鑰（如果已設置）
# 並指定了倉庫別名、PR 標題、源分支、目標分支等信息
# 還可以根據需要添加審閱人等信息
# 以下是一個簡單的調用示例
# 實際使用時，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 這裡只是一個基礎的使用示例，展示如何調用該功能
# 你可以根據具體需求進行更復雜的配置和調用
# 例如，添加更多的參數或處理返回結果等
# 注意：這裡的代碼只是示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 以下代碼僅為演示目的，不保證在所有情況下都能正常工作
# 請根據實際情況進行調整和優化
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景
# 注意：在實際使用中，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 以下代碼只是一個簡單的示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景

高級用法

以下是一個使用多個功能的示例，展示如何創建拉取請求、獲取其詳細信息並添加評論：

# 首先創建一個拉取請求
# 假設環境變量已正確配置
# 這裡只是示意，實際使用時根據情況修改參數
# 創建一個拉取請求，指定項目、倉庫、標題等信息
# 注意：project 若未指定，會使用默認項目密鑰（如果已設置）
# 這裡的參數僅為示例，你需要根據實際情況修改
# 例如，將 repository 替換為你實際的倉庫別名
# 將 title 替換為你想要的 PR 標題等
# 調用 create_pull_request 方法創建拉取請求
# 這裡使用了默認的項目密鑰（如果已設置）
# 並指定了倉庫別名、PR 標題、源分支、目標分支等信息
# 還可以根據需要添加審閱人等信息
# 以下是一個簡單的調用示例
# 實際使用時，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 這裡只是一個基礎的使用示例，展示如何調用該功能
# 你可以根據具體需求進行更復雜的配置和調用
# 例如，添加更多的參數或處理返回結果等
# 注意：這裡的代碼只是示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 以下代碼僅為演示目的，不保證在所有情況下都能正常工作
# 請根據實際情況進行調整和優化
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景
# 注意：在實際使用中，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 以下代碼只是一個簡單的示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景

# 然後獲取該拉取請求的詳細信息
# 假設上一步創建拉取請求成功並得到了 prId
# 這裡使用 get_pull_request 方法獲取詳細信息
# 同樣需要指定項目和倉庫信息
# 並傳入上一步得到的 prId
# 以下是一個簡單的調用示例
# 實際使用時，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 這裡只是一個基礎的使用示例，展示如何調用該功能
# 你可以根據具體需求進行更復雜的配置和調用
# 例如，處理返回結果或進行進一步的分析等
# 注意：這裡的代碼只是示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 以下代碼僅為演示目的，不保證在所有情況下都能正常工作
# 請根據實際情況進行調整和優化
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景
# 注意：在實際使用中，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 以下代碼只是一個簡單的示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景

# 最後在該拉取請求中添加評論
# 假設上一步獲取詳細信息成功
# 這裡使用 add_comment 方法添加評論
# 同樣需要指定項目、倉庫和 prId
# 並傳入評論文本
# 還可以根據需要指定父評論的 ID 進行回覆
# 以下是一個簡單的調用示例
# 實際使用時，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 這裡只是一個基礎的使用示例，展示如何調用該功能
# 你可以根據具體需求進行更復雜的配置和調用
# 例如，處理返回結果或進行進一步的操作等
# 注意：這裡的代碼只是示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 以下代碼僅為演示目的，不保證在所有情況下都能正常工作
# 請根據實際情況進行調整和優化
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景
# 注意：在實際使用中，確保環境變量和參數的正確性
# 以保證請求能夠成功發送到 Bitbucket 服務器
# 以下代碼只是一個簡單的示例，不包含完整的錯誤處理和驗證邏輯
# 在實際應用中，建議添加適當的錯誤處理和驗證機制
# 以確保程序的健壯性和穩定性
# 例如，處理可能的網絡錯誤、身份驗證失敗等情況
# 並根據 Bitbucket 服務器的響應進行相應的處理
# 這裡只是一個簡單的調用示例，幫助你快速瞭解如何使用該功能
# 你可以根據自己的需求進行擴展和定製
# 例如，將其集成到自動化腳本或其他應用程序中
# 以實現更高效的拉取請求管理
# 注意：在使用過程中，確保遵守 Bitbucket 服務器的使用規則和限制
# 以避免不必要的問題和錯誤
# 以下代碼只是一個基礎示例，你可以根據實際情況進行修改和完善
# 例如，添加更多的註釋或文檔說明，以便更好地理解和維護代碼
# 這裡的代碼只是一個起點，你可以根據自己的需求進行進一步的開發和優化
# 以滿足特定的業務需求和場景

📚 詳細文檔

第三方庫

該服務器依賴以下第三方庫：

• @smithery/cli - Smithery CLI 工具，用於工具安裝和管理
• axios - Promise 基礎的 HTTP 客戶端
• winston - 輕量級的日誌記錄庫

配置

環境變量

該服務器使用以下環境變量：

日誌記錄

該服務器將所有操作記錄到 bitbucket.log 中，使用 Winston 進行調試和監控。