mcp-server-atlassian-bitbucket

概述

这个基于 TypeScript 的 MCP 服务器允许 Claude、Cursor 等 AI 助手通过标准化工具与 Bitbucket 代码库和拉取请求交互。它支持所有 Bitbucket Cloud API 操作，包括列出工作区、代码库、分支、提交以及管理拉取请求。服务器具有优化的 TOON 输出格式，可减少 30-60% 的令牌消耗，并支持传统的应用密码和现代的范围化 API 令牌进行身份验证。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• bb_get

  GET any Bitbucket API endpoint (read data)

  试试:List all repositories in my main workspace试试:Show me details about the backend-api repository试试:Get the commit history for the feature-auth branch
• bb_post

  POST to any endpoint (create resources)

  试试:Create a pull request from feature-login to main branch试试:Create a new issue in the bug-tracker repository
• bb_put

  PUT to any endpoint (replace resources)

  试试:Update pull request #42 with new title and description试试:Replace the contents of the configuration file
• bb_patch

  PATCH any endpoint (partial updates)

  试试:Add a comment to PR #15 saying the tests passed试试:Update only the description of an issue
• bb_delete

  DELETE any endpoint (remove resources)

  试试:Delete pull request #33试试:Remove the feature-auth branch from the repository
• bb_clone

  Clone a repository locally

  试试:Clone the frontend repository to my local machine试试:Clone backend-api repository to /projects/backend

可对比工具

安装

# 范围化 API 令牌（推荐）
export ATLASSIAN_USER_EMAIL="your.email@company.com"
export ATLASSIAN_API_TOKEN="your_scoped_api_token"

# 或者传统应用密码（已弃用）
export ATLASSIAN_BITBUCKET_USERNAME="your_username"
export ATLASSIAN_BITBUCKET_APP_PASSWORD="your_app_password"

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

FAQ

此服务器是否兼容 Bitbucket Server/Data Center？

不，此服务器仅适用于 Bitbucket Cloud。不支持 Bitbucket Server 或 Data Center。

支持哪些身份验证方法？

服务器支持传统的应用密码（2026年6月弃用）和现代的范围化 API 令牌。对于新设置，推荐使用范围化 API 令牌。

使用此服务器时如何减少令牌消耗？

使用内置的 TOON 输出格式（默认，可减少 30-60% 的令牌）并始终应用 JMESPath 过滤，仅从 API 响应中提取所需数据。

mcp-server-atlassian-bitbucket 对比