MCP Bitbucket Python 🦊

用于 Bitbucket 集成的 MCP 服务器的 Python 实现。MCP（模型上下文协议）为 AI 应用程序提供安全的本地工具访问。该服务器与您的 AI 应用程序在同一台机器上本地运行。

安装

# Install the server locally
git clone https://github.com/kallows/mcp-bitbucket.git

Related MCP server: Model Context Protocol (MCP) Server

可用工具

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

• bb_create_repository ：创建一个新的 Bitbucket 存储库

  • 必需：名称（存储库名称）

  • 可选：描述、工作区（默认为 kallows）、project_key、is_private（默认值：true）、has_issues（默认值：true）

• bb_create_branch ：在存储库中创建一个新分支

  • 必需：repo_slug、branch（新分支的名称）

  • 可选：工作区（默认为 kallows）、起始点（默认为 main）

• 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、issue_id

  • 可选：工作区（默认为 kallows）

• bb_search_repositories ：使用查询语法搜索 Bitbucket 存储库

  • 必需：查询（例如，'name〜“test”'或'project.key =“PROJ”'）

  • 可选：工作区（默认为 kallows）、页面（默认值：1）、pagelen（默认值：10，最大值：100）

• bb_delete_file ：从存储库中删除文件

  • 必需：repo_slug，路径

  • 可选：工作区（默认为 kallows）、分支（默认为主）、消息（提交消息）

• bb_create_pull_request ：创建拉取请求

  • 必需：repo_slug、title、source_branch

  • 可选：工作区（默认为 kallows）、destination_branch（默认为 main）、描述、close_source_branch（默认值：true）

环境设置

服务器需要将 Bitbucket 凭证设置为环境变量：

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

项目结构

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