Bitbucket Server MCP

用于 Bitbucket Server 拉取请求管理的 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

创建一个新的拉取请求。

参数：

• project: Bitbucket 项目密钥（如果设置了 BITBUCKET_DEFAULT_PROJECT，则默认使用）
• repository (必需): 仓库别名
• title (必需): PR 标题
• description: PR 描述
• sourceBranch (必需): 源分支名称
• targetBranch (必需): 目标分支名称
• reviewers: 评审员用户名数组

get_pull_request

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

参数：

• project: Bitbucket 项目密钥（如果设置了 BITBUCKET_DEFAULT_PROJECT，则默认使用）
• repository (必需): 仓库别名
• prId (必需): 拉取请求 ID

merge_pull_request

合并一个拉取请求。

参数：

• project: Bitbucket 项目密钥（如果设置了 BITBUCKET_DEFAULT_PROJECT，则默认使用）
• repository (必需): 仓库别名
• prId (必需): 拉取请求 ID
• message: 合并提交消息
• strategy: 以下之一：
  • merge-commit (默认)
  • squash
  • fast-forward

decline_pull_request

拒绝一个拉取请求。

参数：

• project: Bitbucket 项目密钥（如果设置了 BITBUCKET_DEFAULT_PROJECT，则默认使用）
• repository (必需): 仓库别名
• prId (必需): 拉取请求 ID
• message: 拒绝原因

add_comment

向拉取请求添加评论。

参数：

• project: Bitbucket 项目密钥（如果设置了 BITBUCKET_DEFAULT_PROJECT，则默认使用）
• repository (必需): 仓库别名
• prId (必需): 拉取请求 ID
• text (必需): 评论文本
• parentId: 回复时的父评论 ID

get_diff

检索拉取请求的差异。

参数：

• project: Bitbucket 项目密钥（如果设置了 BITBUCKET_DEFAULT_PROJECT，则默认使用）
• repository (必需): 仓库别名
• prId (必需): 拉取请求 ID
• contextLines: 上下文行数（默认: 10）

get_reviews

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

参数：

• project: Bitbucket 项目密钥（如果设置了 BITBUCKET_DEFAULT_PROJECT，则默认使用）
• repository (必需): 仓库别名
• 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: 在工具调用中未指定时使用的默认项目密钥

日志

为了调试和监控目的，服务器使用Winston将所有操作记录到bitbucket.log中。