Bitbucket Code Review MCP

🔍 比特桶代码审查MCP服务器

一 MCP（模型上下文协议） 支持AI代理的服务器，如 Gemini CLI 和 反重力 在上发布格式良好的代码审查评论 比特桶云 pull请求。

MCP本身不审查代码 --它为代理提供了创建标记为的评论的工具 [🤖 AI Review] 人工审查员将审查和批准。

✨ 特性

🚀 设置

先决条件

• Node.js 22+ （LTS）通过 非易失性存储器
• A. 比特桶云 帐户与a API代币

- 所需权限： Repositories: Read, Pull requests: Read & Write

从GitHub安装

使用此MCP的最简单方法是直接从GitHub使用，无需克隆：

# npx directly from GitHub (recommended for agents)
npx -y github:Adyel/bitbucket-code-review-mcp

或者克隆并在本地构建：

git clone https://github.com/Adyel/bitbucket-code-review-mcp.git
cd bitbucket-code-review-mcp
nvm use 22
npm install   # auto-builds via `prepare` script

环境变量

# Required
export BITBUCKET_EMAIL="your-atlassian-email@example.com"
export BITBUCKET_API_TOKEN="your-api-token"

# Optional defaults (avoids specifying in every tool call)
# These values come from your Bitbucket repo URL:
#   https://bitbucket.org/{workspace}/{repo_slug}
# e.g. https://bitbucket.org/acme-corp/backend-api
#   → BITBUCKET_DEFAULT_WORKSPACE=acme-corp
#   → BITBUCKET_DEFAULT_REPO_SLUG=backend-api
export BITBUCKET_DEFAULT_WORKSPACE="your-workspace"
export BITBUCKET_DEFAULT_REPO_SLUG="your-repo"

# Optional: customize the AI review tag (default: 🤖 AI Review)
# Set to empty string to disable tagging entirely: BITBUCKET_AI_TAG=""
export BITBUCKET_AI_TAG="🤖 AI Review"

# Optional: create comments as pending/draft (default: false)
# When true, comments are not published until the reviewer submits the review
export BITBUCKET_COMMENTS_PENDING=false

🔌 代理配置

Gemini CLI

添加 ~/.gemini/settings.json:

{
  "mcpServers": {
    "bitbucket-code-review": {
      "command": "npx",
      "args": ["-y", "github:Adyel/bitbucket-code-review-mcp"],
      "env": {
        "BITBUCKET_EMAIL": "your-atlassian-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token",
        "BITBUCKET_DEFAULT_WORKSPACE": "your-workspace",
        "BITBUCKET_DEFAULT_REPO_SLUG": "your-repo"
      }
    }
  }
}

本地安装替代方案：如果您在本地克隆了仓库，请替换 command 和 args 与： ``json "command": "node", "args": ["/absolute/path/to/bitbucket-code-review-mcp/dist/index.js"] ``

反重力/其他MCP客户端

{
  "bitbucket-code-review": {
    "command": "npx",
    "args": ["-y", "github:Adyel/bitbucket-code-review-mcp"],
    "env": {
      "BITBUCKET_EMAIL": "your-atlassian-email@example.com",
      "BITBUCKET_API_TOKEN": "your-api-token",
      "BITBUCKET_DEFAULT_WORKSPACE": "your-workspace",
      "BITBUCKET_DEFAULT_REPO_SLUG": "your-repo"
    }
  }
}

🛠️ 可用工具

公关发现

代码审查意见

任务

🔒 安全防护装置

• 删除保护: delete_comment 首先获取注释并检查 [AI Review] 标签。无法通过此MCP删除人工评论。
• 更新可追溯性: update_comment 对任何评论（人工智能或人类）都有效，但总是附加一个 [✏️ Updated by AI] 标记，这样每一个变化都是可追溯的。
• 可配置标签：设置 BITBUCKET_AI_TAG env-var用于自定义标签，或设置为 "" 完全禁用标记。
• 有待评论：设置 BITBUCKET_COMMENTS_PENDING=true 将评论创建为草稿，仅在审阅者提交审阅时发布。

🔄 韧性和分页

• 自动分页：所有列表端点(list_pull_requests, list_comments, list_pull_request_files, list_tasks)自动跟随Bitbucket的 next URL返回完整结果，即使是大型PR。
• 使用回退重试：API请求在HTTP 429（速率限制）和5xx（服务器错误）上自动重试，并遵循 Retry-After 标题。

🎨 注释格式

所有评论都会自动标记并支持严重级别：

[🤖 AI Review] 💡 Suggestion
Use optional chaining for safer property access.

[🤖 AI Review] 🐛 Bug
This will throw a NullPointerException when `user` is null.

[🤖 AI Review] 🔒 Security
SQL injection risk — use parameterized queries.

代码建议使用Bitbucket的原生语法：

[🤖 AI Review] 💡 Suggestion
Use optional chaining here

const name = user?.name ?? 'default';

📁 项目结构

src/
├── index.ts               # Entry point (Zod env validation, --version)
├── bitbucket-client.ts    # API client (auth, pagination, retry)
├── comment-formatter.ts   # Comment formatting & AI tag guards
├── schemas/
│   └── shared.ts          # Shared Zod input schemas
├── utils/
│   └── response.ts        # Response helpers & error handling
└── tools/
    ├── index.ts            # Tool registration entry point
    ├── pr-discovery.ts     # PR listing, diff, file content tools
    ├── comments.ts         # Inline, file-level, general comments
    ├── tasks.ts            # Task create/list/update
    └── bulk.ts             # Batch inline comments

🤝 贡献

看 贡献.md 用于开发设置、添加工具和发布过程。

命令行界面

node dist/index.js --version   # Print version and exit

许可证

麻省理工学院