Garc33 Bitbucket Server MCP Server

🚀 Bitbucket 服务器 MCP

MCP（模型上下文协议）服务器用于管理 Bitbucket Server 拉取请求，提供了通过 MCP 协议与 Bitbucket Server API 交互的工具和资源，助力高效处理拉取请求相关事务。

🚀 快速开始

需求

• Node.js >= 16

安装

npm install

构建

npm run build

✨ 主要特性

该服务器为 Bitbucket Server 集成提供了以下实用工具：

create_pull_request

创建新的拉取请求。 参数：

get_pull_request

获取特定拉取请求的详细信息。 参数：

merge_pull_request

合并拉取请求。 参数：

decline_pull_request

拒绝拉取请求。 参数：

add_comment

向拉取请求添加评论。 参数：

get_diff

获取拉取请求的代码差分。 参数：

get_reviews

获取拉取请求的审查历史，包括批准和评论。 参数：

📦 依赖项

• @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",
        // 身份验证（选择一种）：
        // 选项 1：个人访问令牌
        "BITBUCKET_TOKEN": "your-access-token",
        // 选项 2：用户名/密码
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-password"
      }
    }
  }
}

环境变量

• BITBUCKET_URL（必需）：Bitbucket Server 实例的基础 URL
• 身份验证（以下其中一种是必需的）：
  • BITBUCKET_TOKEN：个人访问令牌
  • BITBUCKET_USERNAME 和 BITBUCKET_PASSWORD：基本身份验证凭据

日志记录

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