MCP Server Bitbucket

比特桶MCP服务器

用于Bitbucket API操作的MCP服务器。适用于Claude Code、Claude Desktop、Cursor和任何兼容MCP的客户端。

语言版本

此存储库包含 TypeScript 和 python 实现：

备注TypeScript版本用于Smithery部署。两个版本提供相同的功能。

特性

• 仓库：获取、创建、删除、列出、更新（移动到项目、重命名）
• 拉取请求：创建、获取、列出、合并、批准、拒绝、请求更改、评论、差异
• 管道：触发器、获取状态、列表、查看日志、停止
• 分支：列表，获取
• 项目：列表，获取
• 提交：列表，获取详细信息，比较/区分分支
• 提交状态：获取构建状态，创建状态（CI/CD集成）
• 部署：列出环境、获取环境详细信息、部署历史记录
• 网络钩子：列表、创建、获取、删除
• 标签：列表、创建、删除
• 分行限制：列出、创建、删除分支保护规则
• 源代码浏览：读取文件，列出目录而不进行克隆
• 存储库权限：管理用户和组权限
• 管道变量：管理CI/CD环境变量
• MCP提示：可重用的工作流模板（代码审查、发行说明等）
• MCP资源：可浏览的工作区数据

快速开始

TypeScript（推荐用于Smithery）

# Install globally
npm install -g mcp-server-bitbucket

# Or run directly with npx
npx mcp-server-bitbucket

python

# Install with pipx
pipx install mcp-server-bitbucket

# Configure Claude Code
claude mcp add bitbucket -s user \
  -e BITBUCKET_WORKSPACE=your-workspace \
  -e BITBUCKET_EMAIL=your-email@example.com \
  -e BITBUCKET_API_TOKEN=your-api-token \
  -- mcp-server-bitbucket

完整安装指南 -包括API令牌创建、权限设置和故障排除。

配置

环境变量

克劳德代码CLI

# TypeScript version
claude mcp add bitbucket -s user \
  -e BITBUCKET_WORKSPACE=your-workspace \
  -e BITBUCKET_EMAIL=your-email@example.com \
  -e BITBUCKET_API_TOKEN=your-api-token \
  -- npx mcp-server-bitbucket

# Python version
claude mcp add bitbucket -s user \
  -e BITBUCKET_WORKSPACE=your-workspace \
  -e BITBUCKET_EMAIL=your-email@example.com \
  -e BITBUCKET_API_TOKEN=your-api-token \
  -- mcp-server-bitbucket

光标IDE

添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["mcp-server-bitbucket"],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

可用工具（共58个）

仓库

拉取请求

管道

trigger_pipeline参数

示例：

# Default pipeline on main
trigger_pipeline(repo_slug="my-repo")

# Custom pipeline
trigger_pipeline(repo_slug="my-repo", custom_pipeline="deploy-staging")

# Custom pipeline on specific commit with variables
trigger_pipeline(
    repo_slug="my-repo",
    commit="abc123def",
    custom_pipeline="deploy-prod",
    variables=[
        {"key": "ENV", "value": "production"},
        {"key": "SECRET", "value": "xxx", "secured": True}
    ]
)

分支机构，承诺，标签

还有更多。..

• 部署： list_environments, get_environment, list_deployment_history
• Webhooks： list_webhooks, create_webhook, get_webhook, delete_webhook
• 分行限制： list_branch_restrictions, create_branch_restriction, delete_branch_restriction
• 源代码浏览： get_file_content, list_directory
• 权限：用户和组权限管理（8个工具）
• 项目： list_projects, get_project

MCP提示

可重复使用的工作流模板：

MCP资源

可浏览的工作区数据：

发展

TypeScript

cd typescript
npm install
npm run build
npm run dev  # Watch mode

python

cd python
uv sync
uv run python -m src.server

创建Bitbucket API令牌

1. 转到Bitbucket中的存储库
2. 导航至 存储库设置 > 访问令牌
3. 点击 创建存储库访问令牌
4. 选择权限：

- 仓库：读取、写入、管理、删除 - 拉取请求：读，写 - 管道：读，写

1. 立即复制令牌

作者

建造于 哈维尔·阿吉拉尔 -AI Agent Architect，专门从事多代理编排和MCP开发。

许可证

麻省理工学院