MCP Bitbucket

🚀 MCP Bitbucket Python 🦊

MCP Bitbucket Python是一個用Python實現的MCP服務器，用於與Bitbucket進行集成。MCP（模型上下文協議）可讓AI應用程序安全地訪問本地工具，該服務器會在與AI應用程序相同的機器上本地運行。

🚀 快速開始

安裝

# 本地安裝服務器
git clone https://github.com/kallows/mcp-bitbucket.git

環境配置

服務器需要將Bitbucket憑證設置為環境變量：

export BITBUCKET_USERNAME="your-username"
export BITBUCKET_APP_PASSWORD="your-app-password"

✨ 主要特性

此MCP服務器提供了以下Bitbucket集成工具：

• bb_create_repository：創建新的Bitbucket倉庫
  • 必填：名稱（倉庫名稱）
  • 可選：描述、工作區（默認為kallows）、項目鍵、是否私有（默認：true）、是否有問題跟蹤（默認：true）
• bb_create_branch：在倉庫中創建新分支
  • 必填：repo_slug、分支（新分支的名稱）
  • 可選：工作區（默認為kallows）、起始點（默認為主分支）
• bb_delete_repository：刪除Bitbucket倉庫
  • 必填：repo_slug
  • 可選：工作區（默認為kallows）
• bb_read_file：從倉庫讀取文件
  • 必填：repo_slug、路徑（倉庫中的文件路徑）
  • 可選：工作區（默認為kallows）、分支（默認為主/主分支）
• bb_write_file：創建或更新倉庫中的文件
  • 必填：repo_slug、路徑、內容
  • 可選：工作區（默認為kallows）、分支（默認為主分支）、消息（提交信息）
• bb_create_issue：在倉庫中創建問題
  • 必填：repo_slug、標題、內容
  • 可選：工作區（默認為kallows）、類型（bug/enhancement/proposal/task）、優先級（trivial/minor/major/critical/blocker）
• bb_delete_issue：刪除倉庫中的問題
  • 必填：repo_slug、問題ID
  • 可選：工作區（默認為kallows）
• bb_search_repositories：使用查詢語法搜索Bitbucket倉庫
  • 必填：查詢（例如：'name ~ "test"' 或 'project.key = "PROJ"')
  • 可選：工作區（默認為kallows）、頁碼（默認：1）、每頁長度（默認：10，最大：100）
• bb_delete_file：刪除倉庫中的文件
  • 必填：repo_slug、路徑
  • 可選：工作區（默認為kallows）、分支（默認為主分支）、消息（提交信息）
• bb_create_pull_request：創建拉取請求
  • 必填：repo_slug、標題、源分支
  • 可選：工作區（默認為kallows）、目標分支（默認為主分支）、描述、是否關閉源分支（默認：true）

🔧 技術細節

項目結構

mcp-bitbucket/
├── README.md
├── pyproject.toml
├── src/
│   └── bitbucket_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_bb_api.py
    └── test_bb_integration.py