项目简介

Bitbucket Server MCP 是一个专业的 MCP 服务器实现，专为集成和自动化 Bitbucket Server 的工作流程而设计。它通过 Model Context Protocol 标准，将 Bitbucket Server 的核心功能（如仓库操作、拉取请求管理、代码评审等）暴露给兼容的 LLM 客户端，从而实现智能化和自动化开发流程。

主要功能点

• 列出 Bitbucket 项目下的代码仓库、分支和拉取请求。
• 创建、更新和合并拉取请求（支持不同的合并策略）。
• 拒绝和删除拉取请求。
• 在拉取请求中添加评论和行内代码建议。
• 获取拉取请求的详细信息、差异对比（Diff）和评审状态。
• 高效处理大型代码差异。
• 为 MCP 客户端提供一系列可调用的 Bitbucket 相关工具。

安装步骤

推荐使用 npx 直接运行，无需本地安装：

• 确保系统已安装 Node.js 和 npm/npx。
• 直接运行命令 'npx -y bitbucket-server-mcp'。

如果需要本地安装：

• 克隆项目仓库。
• 进入项目目录。
• 运行 'npm install' 安装依赖。
• 运行 'npm run build' 构建项目。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动信息才能连接。以下是配置 Bitbucket Server MCP 的关键信息，通常添加到 MCP 客户端的配置文件中（例如，一个 JSON 文件）：

• 'name': 服务器的唯一名称，例如 'bitbucket-server-mcp'。
• 'command': 启动服务器的命令。
  • 如果使用 npx 方式运行，命令为 'npx'。
  • 如果本地安装后使用 node 运行，命令为 'node'。
• 'args': 启动命令的参数。
  • 使用 npx 时，参数为 '["-y", "bitbucket-server-mcp"]'。
  • 使用本地 node 运行时，参数为服务器主文件路径，例如：
    • Windows: '["C:\path\to\bitbucket-server-mcp\build\index.js"]'
    • Mac/Linux: '["/path/to/bitbucket-server-mcp/build/index.js"]'。
• 'env': 传递给服务器进程的环境变量。这是配置 Bitbucket Server 连接信息的关键。必须包含以下变量：
  • 'BITBUCKET_URL': 您的 Bitbucket Server 的基础 URL (例如 'https://your-bitbucket-server')。
  • 'BITBUCKET_TOKEN': 用于认证的个人访问令牌。
  • 可选变量包括 'BITBUCKET_DEFAULT_PROJECT' (默认项目key)、'BITBUCKET_DEFAULT_REVIEWERS' (逗号分隔的默认评审人用户名)、'BITBUCKET_USERNAME' 和 'BITBUCKET_PASSWORD' (如果不用令牌认证)。

MCP 客户端会根据这些配置信息启动并连接 Bitbucket Server MCP 服务器。

基本使用方法

通常，您无需直接启动或与此服务器交互。它是作为 MCP 客户端（如一个支持 MCP 的 LLM 应用程序或命令行工具）的后台进程运行。一旦 MCP 客户端配置并成功连接到 Bitbucket Server MCP，您的 LLM 应用程序就可以通过标准 MCP 协议调用此服务器提供的各种工具（如创建拉取请求、添加评论等），从而实现与 Bitbucket Server 的集成和自动化交互。