Bitbucket Server MCP

Bitbucket Server MCP

用于管理 Bitbucket Server Pull Request 的 MCP（Model Context Protocol）服务。此服务提供工具和资源，可通过 MCP 协议与 Bitbucket Server API 交互。

要求

• Node.js >= 16

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 Bitbucket Server：

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

手动安装

npm install

构建

npm run build

功能

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

create_pull_request

创建新的 Pull Request。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• title（必需）：PR 标题
• description：PR 描述
• sourceBranch（必需）：源分支名称
• targetBranch（必需）：目标分支名称
• reviewers：审阅者用户名数组

get_pull_request

获取特定 Pull Request 的详细信息。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• prId（必需）：Pull Request ID

merge_pull_request

合并 Pull Request。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• prId（必需）：Pull Request ID
• message：合并提交消息
• strategy：以下选项之一：
  • merge-commit（默认）
  • squash
  • fast-forward

decline_pull_request

拒绝 Pull Request。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• prId（必需）：Pull Request ID
• message：拒绝原因

add_comment

向 Pull Request 添加评论。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• prId（必需）：Pull Request ID
• text（必需）：评论内容
• parentId：用于回复的父评论 ID

get_diff

获取 Pull Request 的差异。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• prId（必需）：Pull Request ID
• contextLines：上下文行数（默认：10）

get_reviews

获取 Pull Request 的审阅历史记录，包括批准和审阅。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• prId（必需）：Pull Request ID

push_files

将多个文件通过单次提交推送到仓库分支。

参数：

• project：Bitbucket 项目密钥（若已设置 BITBUCKET_DEFAULT_PROJECT，则默认为该值）
• repository：仓库 slug（若已设置 BITBUCKET_DEFAULT_REPOSITORY，则默认为该值）
• branch（必需）：要推送到的分支名称
• message（必需）：提交消息
• files（必需）：文件对象数组，每个对象包含：
  • path（必需）：相对于仓库根目录的文件路径
  • content（必需）：要推送到文件中的内容

依赖项

• @modelcontextprotocol/sdk - MCP 协议实现的 SDK
• axios - 用于 API 请求的 HTTP 客户端
• winston - 日志记录框架

配置

服务器需要在 VSCode MCP 设置文件中进行配置。以下是示例配置：

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/path/to/bitbucket-server/build/index.js"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        // Authentication (choose one):
        // Option 1: Personal Access Token
        "BITBUCKET_TOKEN": "your-access-token",
        // Option 2: Username/Password
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-password",
        // Optional: Default project
        "BITBUCKET_DEFAULT_PROJECT": "your-default-project",
        // Optional: Default repository
        "BITBUCKET_DEFAULT_REPOSITORY": "your-default-repository"
      }
    }
  }
}

环境变量

• BITBUCKET_URL（必需）：Bitbucket Server 实例的基础 URL
• 身份验证（以下选项之一为必需）：
  • BITBUCKET_TOKEN：个人访问令牌
  • BITBUCKET_USERNAME 和 BITBUCKET_PASSWORD：基本身份验证凭据
• BITBUCKET_DEFAULT_PROJECT：未在工具调用中指定时使用的默认项目键
• BITBUCKET_DEFAULT_REPOSITORY：未在工具调用中指定时使用的默认仓库标识

日志记录

服务器使用 Winston 将所有操作记录到 bitbucket.log，以便进行调试和监控。