MCP Bitbucket Python 🦊

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

安装

# 在本地安装服务器
git clone https://github.com/kallows/mcp-bitbucket.git

可用工具

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

• bb_create_repository: 创建一个新的 Bitbucket 仓库

  • 必需: name (仓库名称)
  • 可选: description, workspace (默认为 kallows), project_key, is_private (默认: true), has_issues (默认: true)

• bb_create_branch: 在仓库中创建一个新的分支

  • 必需: repo_slug, branch (新分支的名称)
  • 可选: workspace (默认为 kallows), start_point (默认为 main)

• bb_delete_repository: 删除一个 Bitbucket 仓库

  • 必需: repo_slug
  • 可选: workspace (默认为 kallows)

• bb_read_file: 从仓库中读取一个文件

  • 必需: repo_slug, path (仓库中的文件路径)
  • 可选: workspace (默认为 kallows), branch (默认为 main/master)

• bb_write_file: 在仓库中创建或更新一个文件

  • 必需: repo_slug, path, content
  • 可选: workspace (默认为 kallows), branch (默认为 main), message (提交消息)

• bb_create_issue: 在仓库中创建一个 issue

  • 必需: repo_slug, title, content
  • 可选: workspace (默认为 kallows), kind (bug/enhancement/proposal/task), priority (trivial/minor/major/critical/blocker)

• bb_delete_issue: 从仓库中删除一个 issue

  • 必需: repo_slug, issue_id
  • 可选: workspace (默认为 kallows)

• bb_search_repositories: 使用查询语法搜索 Bitbucket 仓库

  • 必需: query (例如, 'name ~ "test"' 或 'project.key = "PROJ"')
  • 可选: workspace (默认为 kallows), page (默认: 1), pagelen (默认: 10, 最大: 100)

• bb_delete_file: 从仓库中删除一个文件

  • 必需: repo_slug, path
  • 可选: workspace (默认为 kallows), branch (默认为 main), message (提交消息)

• bb_create_pull_request: 创建一个 pull request

  • 必需: repo_slug, title, source_branch
  • 可选: workspace (默认为 kallows), destination_branch (默认为 main), description, 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