Bitbucket 服务器 MCP

用于管理 Bitbucket Server 拉取请求的 MCP（模型上下文协议）服务器。该服务器提供通过 MCP 协议与 Bitbucket Server API 交互的工具和资源。

铁匠徽章

要求

Node.js >= 16

Related MCP server: GitHub PR Comments MCP Server

安装

通过 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`

创建一个新的拉取请求。

参数：

project ：Bitbucket 项目密钥（如果设置，则默认为 BITBUCKET_DEFAULT_PROJECT）
repository （必需）：存储库 slug
title （必填）：PR 标题
description ：PR 描述
sourceBranch （必需）：源分支名称
targetBranch （必填）：目标分支名称
reviewers ：审阅者用户名数组

`get_pull_request`

检索有关特定拉取请求的详细信息。

参数：

project ：Bitbucket 项目密钥（如果设置，则默认为 BITBUCKET_DEFAULT_PROJECT）
repository （必需）：存储库 slug
prId （必填）：拉取请求 ID

`merge_pull_request`

合并拉取请求。

参数：

project ：Bitbucket 项目密钥（如果设置，则默认为 BITBUCKET_DEFAULT_PROJECT）
repository （必需）：存储库 slug
prId （必填）：拉取请求 ID
message ：合并提交消息
strategy ：以下之一：
- merge-commit （默认）
- squash
- fast-forward

`decline_pull_request`

拒绝拉取请求。

参数：

project ：Bitbucket 项目密钥（如果设置，则默认为 BITBUCKET_DEFAULT_PROJECT）
repository （必需）：存储库 slug
prId （必填）：拉取请求 ID
message ：拒绝的原因

`add_comment`

向拉取请求添加评论。

参数：

project ：Bitbucket 项目密钥（如果设置，则默认为 BITBUCKET_DEFAULT_PROJECT）
repository （必需）：存储库 slug
prId （必填）：拉取请求 ID
text （必填）：评论文本
parentId ：回复的父评论 ID

`get_diff`

检索拉取请求的差异。

参数：

project ：Bitbucket 项目密钥（如果设置，则默认为 BITBUCKET_DEFAULT_PROJECT）
repository （必需）：存储库 slug
prId （必填）：拉取请求 ID
contextLines ：上下文行数（默认值：10）

`get_reviews`

获取拉取请求的审核历史记录，包括批准和审核。

参数：

project ：Bitbucket 项目密钥（如果设置，则默认为 BITBUCKET_DEFAULT_PROJECT）
repository （必需）：存储库 slug
prId （必填）：拉取请求 ID

依赖项

@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"
      }
    }
  }
}

环境变量

BITBUCKET_URL （必需）：Bitbucket Server 实例的基本 URL
身份验证（需要以下其中一项）：
- BITBUCKET_TOKEN ：个人访问令牌
- BITBUCKET_USERNAME和BITBUCKET_PASSWORD ：基本身份验证凭据
BITBUCKET_DEFAULT_PROJECT ：工具调用中未指定时使用的默认项目密钥