K

Kallows

@Kallows/mcp-bitbucket
0 Stars 296 次浏览 Kallows 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "bitbucket-api": {
      "args": [
        "--directory",
        "D:\\\\mcp\\\\mcp-bitbucket",
        "run",
        "-m",
        "mcp_bitbucket.server"
      ],
      "command": "C:\\\\Users\\\\YOURUSERNAME\\\\.local\\\\bin\\\\uv.exe",
      "env": {
        "BITBUCKET_APP_PASSWORD": "your-app-password",
        "BITBUCKET_USERNAME": "your-username"
      }
    }
  }
}

服务介绍

MCP Bitbucket Python 🦊

一个用于Bitbucket集成的MCP服务器的Python实现。MCP(Model Context Protocol)协议允许AI应用程序安全地访问本地工具。该服务器在与您的AI应用程序相同的机器上本地运行。

安装

bash

本地安装服务器

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: 在仓库中创建一个问题

    • 必需: repo_slug, title, content
    • 可选: workspace (默认为 kallows), kind (bug/enhancement/proposal/task), priority (trivial/minor/major/critical/blocker)
  • bb_delete_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: 创建一个拉取请求

    • 必需: repo_slug, title, source_branch
    • 可选: workspace (默认为 kallows), destination_branch (默认为主分支 main), description, close_source_branch (默认: true)

环境设置

服务器需要将Bitbucket凭据设置为环境变量:

bash
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

相关 MCP 服务