Bitbucket Server MCP

用于 Bitbucket Server Pull Request 管理的 MCP (模型上下文协议) 服务器。 此服务器提供通过 MCP 协议与 Bitbucket Server API 交互的工具和资源。

<a href="https://glama.ai/mcp/servers/jskr5c1zq3"><img width="380" height="200" src="https://glama.ai/mcp/servers/jskr5c1zq3/badge" alt="Bitbucket Server MCP server" /></a>

要求

• 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
• title (必需): PR 标题
• description: PR 描述
• sourceBranch (必需): 源分支名称
• targetBranch (必需): 目标分支名称
• reviewers: 审查者用户名数组

get_pull_request

检索有关特定 pull request 的详细信息。

参数：

• project: Bitbucket 项目键 (如果设置，默认为 BITBUCKET_DEFAULT_PROJECT)
• repository (必需): 仓库 slug
• prId (必需): Pull request ID

merge_pull_request

合并 pull request。

参数：

• project: Bitbucket 项目键 (如果设置，默认为 BITBUCKET_DEFAULT_PROJECT)
• repository (必需): 仓库 slug
• prId (必需): Pull request ID
• message: 合并提交消息
• strategy: 以下之一：
  • merge-commit (默认)
  • squash
  • fast-forward

decline_pull_request

拒绝 pull request。

参数：

• project: Bitbucket 项目键 (如果设置，默认为 BITBUCKET_DEFAULT_PROJECT)
• repository (必需): 仓库 slug
• prId (必需): Pull request ID
• message: 拒绝原因

add_comment

向 pull request 添加评论。

参数：

• project: Bitbucket 项目键 (如果设置，默认为 BITBUCKET_DEFAULT_PROJECT)
• repository (必需): 仓库 slug
• prId (必需): Pull request ID
• text (必需): 评论文本
• parentId: 父评论 ID，用于回复

get_diff

检索 pull request 的 diff。

参数：

• project: Bitbucket 项目键 (如果设置，默认为 BITBUCKET_DEFAULT_PROJECT)
• repository (必需): 仓库 slug
• prId (必需): Pull request ID
• contextLines: 上下文行数 (默认: 10)

get_reviews

获取 pull request 的审查历史记录，包括批准和审查。

参数：

• project: Bitbucket 项目键 (如果设置，默认为 BITBUCKET_DEFAULT_PROJECT)
• repository (必需): 仓库 slug
• prId (必需): Pull request 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，以用于调试和监控目的。