Token导航 LogoToken导航TokenDH.com
Bitbucket Server MCP logo
开发工具stdio官方级别未说明来源级核验

Bitbucket Server MCP

MCP Server

@smithery/cli

Bitbucket Server MCP 是一个用于管理Bitbucket Server拉取请求的服务,提供工具和资源通过MCP协议与Bitbucket Server API交互。

工具数

14

提示词数

0

GitHub Stars

62

资源数

0
代码审查版本控制JavaScriptClaudeClaude DesktopClaude

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

garc33

提供方

garc33

最后核验

2026/5/17 21:09

运行时

Node.js

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

详细介绍

比特桶服务器MCP

MCP(模型上下文协议)服务器,用于Bitbucket服务器拉取请求管理。该服务器提供工具和资源,通过MCP协议与Bitbucket服务器API进行交互。

](https://smithery.ai/server/@garc33/bitbucket-server-mcp-server)

✨ 新功能

  • 🔧 自定义HTTP标头:通过向所有请求添加自定义标头 BITBUCKET_CUSTOM_HEADERS 环境变量(适用于零信任令牌或代理)
  • 📋 公关发现:使用以下命令按州、作者或方向列出和过滤拉取请求 list_pull_requests (修复#14)
  • 🌿 分行管理:使用以下命令列出具有默认分支检测的分支 list_branches,删除合并的分支 delete_branch
  • 📝 提交历史记录:使用分支和作者筛选浏览提交历史记录 list_commits
  • ✅ PR审批:使用以下命令批准和取消批准拉取请求 approve_pull_requestunapprove_pull_request
  • 🔍 高级搜索:使用项目/存储库过滤在存储库中搜索代码和文件 search 工具
  • 📄 文件操作:使用以下命令读取文件内容并浏览存储库目录 get_file_contentbrowse_repository
  • 💬 评论管理:提取并过滤PR评论 get_comments 工具
  • 🔍 项目发现:列出所有可访问的Bitbucket项目 list_projects
  • 📁 存储库浏览:使用以下工具跨项目探索存储库 list_repositories
  • 🔧 灵活的项目支持:将默认项目设置为可选-按命令指定或使用 BITBUCKET_DEFAULT_PROJECT
  • 📖 增强文档:通过使用示例和更好的配置指导改进了README

需求

  • Node.js>=16

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的Bitbucket服务器 铁匠铺:

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

手动安装

npm install

构建

npm run build

特性

服务器提供以下工具,用于全面的Bitbucket服务器集成:

list_projects

发现和探索Bitbucket项目:列出所有可访问的项目及其详细信息。对于项目发现和找到正确的项目密钥以用于其他操作至关重要。

使用案例:

  • 当您不知道确切的项目密钥时,查找可用的项目
  • 探索项目结构和权限
  • 发现您可以访问的新项目

参数:

  • limit:要返回的项目数(默认值:25,最大值:1000)
  • start:开始分页索引(默认值:0)

list_repositories

浏览和发现存储库:探索特定项目内或所有可访问项目中的存储库。返回全面的存储库信息,包括克隆URL和元数据。

使用案例:

  • 查找其他操作的存储库块
  • 探索跨项目的代码库结构
  • 发现您有权访问的存储库
  • 浏览特定项目的存储库

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • limit:要返回的存储库数量(默认值:25,最大值:1000)
  • start:开始分页索引(默认值:0)

create_pull_request

提出代码更改以供审查:创建新的拉取请求以提交代码更改、请求审核或合并功能分支。自动处理分支引用和审阅者分配。

使用案例:

  • 提交功能开发以供审查
  • 提出bug修复
  • 从功能分支请求代码集成
  • 协作进行代码更改

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • title (必填):清晰、描述性的PR标题
  • description:带上下文的详细描述(支持Markdown)
  • sourceBranch (必填):包含更改的源分支
  • targetBranch (必填):合并的目标分支
  • reviewers:审阅者用户名数组
  • sourceProject:源代码仓库的项目密钥(用于来自分叉的跨仓库PR)
  • sourceRepository:源代码仓库的Slug(用于来自分叉的跨仓库PR)
  • includeDefaultReviewers:自动获取并包含为目标分支配置的默认审阅者(默认值:true)

update_pull_request

安全地更新拉取请求:修改现有拉取请求的标题、描述或审阅者,而不会丢失任何元数据。使用读-修改-写模式来保留所有未明确更改的字段。

使用案例:

  • 创建后修复PR标题或描述
  • 在不丢失现有审阅者的情况下添加或替换审阅者
  • 在不影响审批状态的情况下更新PR元数据

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID进行更新
  • title:新标题(如果省略,则保留当前标题)
  • description:新描述(如果省略,则保留当前描述)
  • reviewers:新审阅者列表作为用户名数组(如果省略,则保留当前审阅者)

get_pull_request

全面的公关信息:检索详细的拉取请求信息,包括状态、审阅者、提交和所有元数据。在采取行动之前了解PR状态至关重要。

使用案例:

  • 检查PR审批状态
  • 审查PR详细信息和进度
  • 合并前了解更改
  • 监控PR状态

参数:

  • 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

拒绝不合适的更改:拒绝不应合并的拉取请求,向作者提供反馈。

使用案例:

  • 拒绝不符合标准的更改
  • 关闭与项目方向冲突的PR
  • 要求大量返工
  • 防止不必要的代码集成

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID
  • message:拒绝原因(有助于作者反馈)

add_comment

参与代码审查:添加评论以拉取审查反馈、讨论和协作请求。支持线程对话。

使用案例:

  • 提供代码审查反馈
  • 询问有关具体更改的问题
  • 提出改进建议
  • 参与技术讨论
  • 文件审查决定

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID
  • text (必填):评论内容(支持Markdown)
  • parentId:线程回复的父评论ID
  • state:评论状态: OPEN (默认,立即发布)或 PENDING (草稿,在审阅发布之前仅对您可见)

get_diff

分析代码更改:检索代码差异,准确显示在拉取请求中添加、删除或修改的内容。支持按文件截断,以有效管理大差异。

使用案例:

  • 审查特定的代码更改
  • 了解修改范围
  • 合并前分析影响
  • 检查实施细节
  • 代码质量评估
  • 处理大文件而不会产生过大的输出

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID
  • contextLines:更改周围的上下文线(默认值:10)
  • maxLinesPerFile:每个文件显示的最大行数(可选,如果未指定,则使用BITBUCKET_DIF_MAX_lines_per_file env var,设置为0表示没有限制)

大文件处理: 当文件超过 maxLinesPerFile 限制,它显示:

  • 文件头和元数据(始终保留)
  • 从一开始允许的前60%行
  • 带有文件统计信息的截断消息
  • 从末尾开始的最后40%的允许行
  • 清楚地说明如何查看完整的差异

get_reviews

跟踪审核进度:获取审核历史、审批状态和审核者反馈,以了解审核状态。

使用案例:

  • 检查PR是否已准备好合并
  • 查看谁审核了更改
  • 了解审核反馈
  • 监控审批要求
  • 跟踪审核进度

get_activities

检索拉取请求活动:获取拉取请求的完整活动时间线,包括评论、审阅、提交和其他事件。

使用案例:

  • 阅读评论讨论和反馈
  • 查看完整的公关时间表
  • 跟踪PR中添加/删除的提交
  • 查看审批和审核历史记录
  • 了解完整的公关生命周期

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID

get_comments

仅提取公关评论:过滤器拉取请求活动以仅返回评论,从而更容易在没有评论或其他活动的情况下专注于讨论内容。

使用案例:

  • 阅读公关讨论帖子
  • 提取反馈和问题
  • 专注于没有噪音的评论内容
  • 分析对话流程

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID

search

高级代码和文件搜索:使用Bitbucket搜索API搜索存储库,支持项目/存储库筛选和查询优化。搜索文件内容和文件名。 备注:搜索仅适用于存储库的默认分支。

使用案例:

  • 跨项目查找特定的代码模式
  • 按名称或内容查找文件
  • 在特定项目或存储库中搜索
  • 按文件扩展名筛选

参数:

  • query (必填):搜索查询字符串
  • project:Bitbucket项目密钥限制搜索范围
  • repository:用于存储库特定搜索的存储库slug
  • type:查询优化-“文件”(将查询括在引号中以进行精确的文件名匹配)或“代码”(默认搜索行为)
  • limit:要返回的结果数(默认值:25,最大值:100)
  • start:开始分页索引(默认值:0)

查询语法示例:

  • "README.md" -查找确切的文件名
  • config ext:yml -在YAML文件中查找配置
  • function project:MYPROJECT -在特定项目中搜索“功能”
  • bug fix repo:PROJ/my-repo -在特定存储库中搜索

get_file_content

使用分页读取文件内容:通过分页从支持大文件的存储库中检索特定文件的内容。

使用案例:

  • 读取源代码文件
  • 查看配置文件
  • 提取文档内容
  • 检查特定文件版本

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • filePath (必填):存储库中文件的路径
  • branch:分支或提交哈希(可选,默认为main/master)
  • limit:每个请求的最大行数(默认值:100,最大值:1000)
  • start:分页的起始行号(默认值:0)

browse_repository

探索仓库结构:浏览存储库中的文件和目录,以了解项目组织并定位特定文件。

使用案例:

  • 探索仓库结构
  • 导航目录树
  • 查找文件和文件夹
  • 了解项目组织

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • path:要浏览的目录路径(可选,默认为root)
  • branch:分支或提交哈希(可选,默认为main/master)
  • limit:要返回的最大项目数(默认值:50)

list_pull_requests

发现并过滤拉取请求:在存储库中列出拉取请求,并按状态、作者和方向进行筛选。返回PR元数据,包括标题、作者、分支、审阅者和状态。

使用案例:

  • 在存储库中查找打开的PR
  • 列出您自己的pull请求
  • 查看等待审核的PR
  • 获取合并或拒绝的PR的概述
  • 监控项目中的公关活动

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • state:按PR状态筛选-- OPEN (默认), MERGED, DECLINED,或 ALL
  • author:按作者用户名筛选(完全匹配)
  • direction: INCOMING (针对此回购的PR,默认)或 OUTGOING (此回购的PR)
  • limit:要返回的PR数(默认值:25,最大值:1000)
  • start:开始分页索引(默认值:0)

list_branches

探索存储库分支:使用可选筛选列出存储库中的分支。标识默认分支并显示每个分支的最新提交信息。

使用案例:

  • 查找用于创建或签出PR的分支机构名称
  • 操作前验证分支是否存在
  • 确定默认分支
  • 按名称搜索分支机构

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • filterText:按名称筛选分支(不区分大小写的部分匹配)
  • limit:要返回的分支数(默认值:25,最大值:1000)
  • start:开始分页索引(默认值:0)

list_commits

浏览提交历史记录:使用可选的分支和作者筛选功能列出存储库中的提交。使用此功能可以查看更改、跟踪贡献或了解分支的演变。

使用案例:

  • 查看分支最近的更改
  • 查找特定作者的提交
  • 合并前跟踪提交历史记录
  • 了解分支进化

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • branch:列出提交来源的分支名称(默认为存储库的默认分支)
  • author:按作者姓名或电子邮件筛选(不区分大小写的部分匹配,应用于客户端)
  • limit:要返回的提交数(默认值:25,最大值:1000)
  • start:开始分页索引(默认值:0)

delete_branch

清理合并的分支机构:从存储库中删除分支。包括一个安全检查,以防止删除默认分支。

使用案例:

  • PR合并后清理功能分支
  • 移除陈旧或废弃的树枝
  • 存储库维护和卫生

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • branch (必填):要删除的分行名称

approve_pull_request

批准代码更改:以当前经过身份验证的用户身份批准拉取请求。在PR上记录您的批准,表示更改已准备好合并。

使用案例:

  • 批准已审核的拉取请求
  • 合并准备就绪信号
  • 完整的代码审查工作流程

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):提取请求ID以进行批准

unapprove_pull_request

撤销批准:从拉取请求中删除您的批准。当您在发现问题或PR发生变化后需要撤回之前的批准时,请使用此选项。

使用案例:

  • 发现问题后撤回批准
  • PR范围更改时删除批准
  • 纠正意外批准

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):提取请求ID以从中删除批准

edit_comment

编辑现有评论:修改pull请求的注释文本。处理已发布和待处理(草案)的评论。需要注释版本才能进行乐观锁定。

使用案例:

  • 修正评论中的拼写错误或格式问题
  • 更新现有评论中的信息
  • 重新格式化评论(例如,改为传统评论风格)

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):提取评论所属的请求ID
  • commentId (必填):要编辑的评论的ID
  • text (必填):新增文本内容(支持Markdown)
  • version (必填):乐观锁定注释的当前版本(来自 get_commentsadd_comment 响应)

delete_comment

删除评论:从pull请求中删除注释。需要注释版本才能进行乐观锁定。

使用案例:

  • 删除错误发布的评论
  • 清理不再需要的评论草案

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):提取评论所属的请求ID
  • commentId (必填):要删除的评论的ID
  • version (必填):当前版本的乐观锁定注释

publish_review

发布批量审核:一次发布所有待定(草稿)评论,可选择设置您的审核状态并添加概述评论。这相当于在Bitbucket UI中单击“完成审核”。

使用案例:

  • 在单个操作中发布所有草稿审核意见
  • 批准PR以及审查意见
  • 请求具有“需要工作”状态和反馈的更改

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID
  • commentText:审查的可选概述评论
  • participantStatus:可选审核状态: APPROVED (准备合并)或 NEEDS_WORK (需要更改)。省略一般反馈。

get_code_insights

检索CI/CD分析结果:获取代码洞察报告(SonarQube、安全扫描等)及其对拉取请求的注释。

使用案例:

  • 检查SonarQube质量门状态
  • 审查安全扫描结果
  • 检查代码覆盖率指标
  • 请参阅每个文件的CI/CD分析注释

参数:

  • project:Bitbucket项目密钥(可选,如果未提供,则使用Bitbucket_DEFAULT_project)
  • repository (必填):存储库段塞
  • prId (必填):拉取请求ID

get_dashboard_pull_requests

跨存储库PR仪表板:列出经过身份验证的用户在所有存储库中的拉取请求。使用此功能可以查看您需要查看的PR、您撰写的PR或您正在参与的PR,而无需指定每个项目和存储库。

使用案例:

  • 查看所有等待您审核的PR
  • 列出所有项目中您自己的公开PR
  • 查找您最近参与的合并PR
  • 了解您的公关工作量概览

参数:

  • state:按PR状态筛选: OPEN (默认), MERGED, DECLINED,或 ALL
  • role:按角色筛选: AUTHOR, REVIEWER,或 PARTICIPANT
  • participantStatus:按您的审核状态筛选: APPROVED, UNAPPROVED,或 NEEDS_WORK
  • order:排序顺序: OLDESTNEWEST (默认)
  • closedSince:仅包括在此时间戳(纪元ms)之后更新的已关闭PR
  • limit:要返回的PR数(默认值:25)
  • start:开始分页索引(默认值:0)

用法示例

列出项目和存储库

# List all accessible projects
list_projects

# List repositories in the default project (if BITBUCKET_DEFAULT_PROJECT is set)
list_repositories

# List repositories in a specific project
list_repositories --project "MYPROJECT"

# List projects with pagination
list_projects --limit 10 --start 0

搜索和文件操作

# Search for README files across all projects
search --query "README" --type "file" --limit 10

# Search for specific code patterns in a project
search --query "function getUserData" --type "code" --project "MYPROJECT"

# Search with file extension filter
search --query "config ext:yml" --project "MYPROJECT"

# Browse repository structure
browse_repository --project "MYPROJECT" --repository "my-repo"

# Browse specific directory
browse_repository --project "MYPROJECT" --repository "my-repo" --path "src/components"

# Read file contents
get_file_content --project "MYPROJECT" --repository "my-repo" --filePath "package.json" --limit 20

# Read specific lines from a large file
get_file_content --project "MYPROJECT" --repository "my-repo" --filePath "docs/CHANGELOG.md" --start 100 --limit 50

处理Pull请求

# Create a pull request (using default project)
create_pull_request --repository "my-repo" --title "Feature: New functionality" --sourceBranch "feature/new-feature" --targetBranch "main"

# Create a pull request with specific project
create_pull_request --project "MYPROJECT" --repository "my-repo" --title "Bugfix: Critical issue" --sourceBranch "bugfix/critical" --targetBranch "develop" --description "Fixes critical issue #123"

# Get pull request details
get_pull_request --repository "my-repo" --prId 123

# Get only comments from a PR (no reviews/commits)
get_comments --project "MYPROJECT" --repository "my-repo" --prId 123

# Get full PR activity timeline
get_activities --repository "my-repo" --prId 123

# Merge a pull request with squash strategy
merge_pull_request --repository "my-repo" --prId 123 --strategy "squash" --message "Feature: New functionality (#123)"

发现拉取请求

# List open PRs in a repository (default state: OPEN)
list_pull_requests --repository "my-repo"

# List all PRs regardless of state
list_pull_requests --repository "my-repo" --state "ALL"

# Find PRs by a specific author
list_pull_requests --repository "my-repo" --author "john.doe"

# List merged PRs with pagination
list_pull_requests --repository "my-repo" --state "MERGED" --limit 10 --start 0

分行管理

# List all branches in a repository
list_branches --repository "my-repo"

# Filter branches by name
list_branches --project "MYPROJECT" --repository "my-repo" --filterText "feature"

# Delete a merged branch
delete_branch --repository "my-repo" --branch "feature/completed-work"

提交历史记录

# List recent commits on the default branch
list_commits --repository "my-repo"

# List commits on a specific branch
list_commits --repository "my-repo" --branch "develop" --limit 10

# Filter commits by author
list_commits --repository "my-repo" --author "john.doe"

# Combine branch and author filters
list_commits --project "MYPROJECT" --repository "my-repo" --branch "main" --author "jane"

PR审批工作流程

# Approve a pull request
approve_pull_request --repository "my-repo" --prId 123

# Remove your approval
unapprove_pull_request --repository "my-repo" --prId 123

# Full workflow: review diff, approve, merge
get_diff --repository "my-repo" --prId 123
approve_pull_request --repository "my-repo" --prId 123
merge_pull_request --repository "my-repo" --prId 123 --strategy "squash"

依赖项

  • @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服务器实例的基本URL
  • 身份验证(需要以下之一):

- BITBUCKET_TOKEN:个人访问令牌 - BITBUCKET_USERNAMEBITBUCKET_PASSWORD:基本身份验证凭据

  • BITBUCKET_DEFAULT_PROJECT (可选):在工具调用中未指定时使用的默认项目密钥
  • BITBUCKET_DIFF_MAX_LINES_PER_FILE (可选):在diffs中每个文件显示的默认最大行数。设置为防止大文件压倒输出。可以被覆盖 maxLinesPerFile 参数在 get_diff 电话。
  • BITBUCKET_LOG_PATH (可选):日志文件的自定义路径(默认值: ~/.bitbucket-server-mcp/bitbucket.log)
  • BITBUCKET_READ_ONLY (可选):设置为 true 启用只读模式
  • BITBUCKET_CUSTOM_HEADERS (可选):添加到所有请求中的自定义HTTP标头的逗号分隔列表(格式: Header-Name=value,Another-Header=value2).适用于零信任令牌或代理标头

备注:有了新的可选项目支持,您现在可以:

  • BITBUCKET_DEFAULT_PROJECT 默认情况下使用特定项目
  • 使用 list_projects 发现可用项目
  • 使用 list_repositories 跨项目浏览存储库
  • 通过指定以下内容覆盖默认项目 project 任何工具调用中的参数

只读模式

服务器支持只读模式,用于部署您希望阻止对Bitbucket存储库进行任何修改的情况。启用后,只有安全、不可修改的操作可用。

启用只读模式:设置环境变量 BITBUCKET_READ_ONLY=true

只读模式下的可用工具:

  • list_projects -浏览并列出项目
  • list_repositories -浏览并列出存储库
  • get_pull_request -查看拉取请求详细信息
  • list_pull_requests -列出并过滤拉取请求
  • get_diff -查看代码更改和差异
  • get_reviews -查看审核历史和状态
  • get_activities -查看拉取请求时间线
  • get_comments -查看拉取请求评论
  • search -跨存储库搜索代码和文件
  • get_file_content -读取文件内容
  • browse_repository -浏览存储库结构
  • list_branches -列出存储库分支
  • list_commits -浏览提交历史记录
  • get_code_insights -检索CI/CD分析报告和注释
  • get_dashboard_pull_requests -列出经过身份验证的用户在所有存储库中的PR

只读模式下禁用的工具:

  • create_pull_request -创建新的pull请求
  • update_pull_request -更新拉取请求标题、描述或审阅者
  • merge_pull_request -合并拉取请求
  • decline_pull_request -拒绝拉取请求
  • add_comment -为拉取请求添加评论
  • add_comment_inline -添加内联注释以拉取请求
  • edit_comment -编辑现有评论
  • delete_comment -删除评论
  • publish_review -发布批量评论
  • delete_branch -删除分支
  • approve_pull_request -批准拉取请求
  • unapprove_pull_request -删除PR审批

行为:

  • BITBUCKET_READ_ONLY 未设置或设置为除以下值以外的任何值 true,所有工具功能正常(向后兼容)
  • BITBUCKET_READ_ONLY=true,写入操作被过滤掉,如果调用,将返回错误
  • 这非常适合生产部署、CI/CD集成或任何需要安全、只读Bitbucket访问的场景

日志记录

服务器使用Winston记录所有操作,用于调试和监控目的。

日志文件位置 (按优先顺序):

  1. BITBUCKET_LOG_PATH 环境变量--自定义路径
  2. ~/.bitbucket-server-mcp/bitbucket.log --默认位置

如果日志目录不存在,则会自动创建。

示例:在MCP配置中设置自定义日志路径:

{
  "env": {
    "BITBUCKET_LOG_PATH": "/var/log/bitbucket-mcp/server.log"
  }
}

自定义HTTP标头

您可以使用 BITBUCKET_CUSTOM_HEADERS 环境变量。这对于零信任安全令牌、代理标头或基础架构所需的任何其他标头都很有用。

格式:逗号分隔的键值对,其中值可以包含等号:

Header-Name=value,Another-Header=value2

单标题示例:

{
  "env": {
    "BITBUCKET_CUSTOM_HEADERS": "X-Zero-Trust-Token=your-token-here"
  }
}

多标题示例:

{
  "env": {
    "BITBUCKET_CUSTOM_HEADERS": "X-Custom-Header=value1,X-Proxy-Auth=token123"
  }
}

目录标签

目录标签

代码审查版本控制JavaScriptClaude本地部署项目管理团队协作代码合并

支持客户端

Claude DesktopClaude

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

token

运行时(runtime,运行环境)

Node.js

部署方式(deploymentType,部署类型)

remote-capable

来源包(packageName,安装包名)

@smithery/cli

工具数量(toolCount,工具数)

14

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiotokenremote-capable

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP