
Atlassian Bitbucket MCP Server

2025.04.14
9
TypeScript代码协作AI 集成版本控制交流协作
Atlassian Bitbucket MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在作为 AI 助手(如 Anthropic 的 Claude、Cursor AI 或其他 MCP 兼容客户端)与 Atlassian Bitbucket 实例之间的桥梁。它允许 AI 安全地访问和实时交互您的代码仓库、拉取请求和工作区。该服务遵循最小输入、最大输出的哲学,提供丰富的代码可视化、安全的本地认证、直观的 Markdown 响应以及完整的 Bitbucket 集成。
View on GitHub
Overview
基本能力
产品定位
Atlassian Bitbucket MCP Server 是一个连接 AI 助手与 Bitbucket 的工具,旨在提升开发团队与 AI 协作的效率。
核心功能
- 最小输入,最大输出:仅需简单的标识符(如
workspaceSlug
和repoSlug
)即可获取全面的信息。 - 丰富的代码可视化:提供文件统计、差异视图和代码修改的智能上下文。
- 安全的本地认证:凭证不存储在服务器中,仅在本地运行,确保数据安全。
- 直观的 Markdown 响应:所有响应均使用结构化的 Markdown 格式,便于阅读和导航。
- 完整的 Bitbucket 集成:支持访问工作区、仓库、拉取请求、评论、代码搜索等功能。
适用场景
- 团队协作:AI 助手协助管理代码仓库、拉取请求和评论。
- 代码审查:通过 AI 快速获取代码变更的详细视图和上下文。
- 自动化任务:AI 自动创建拉取请求或搜索代码片段。
工具列表
list_workspaces
:列出可用的 Bitbucket 工作区。get_workspace
:获取特定工作区的详细信息。list_repositories
:列出工作区中的仓库。get_repository
:获取特定仓库的详细信息。search
:搜索 Bitbucket 内容(仓库、拉取请求、提交、代码)。list_pull_requests
:列出仓库中的拉取请求。get_pull_request
:获取拉取请求的详细信息(包括代码差异)。list_pr_comments
:列出拉取请求的评论。add_pr_comment
:向拉取请求添加评论(支持行内评论)。pull_requests_create
:创建新的拉取请求。
常见问题解答
- 如何认证?:支持 Bitbucket 应用密码或 Atlassian API 令牌。
- 凭证存储在哪里?:凭证仅存储在本地配置文件中或通过环境变量传递,不保存在服务器中。
- 如何启动服务器?:通过
npx
或全局安装后直接运行。
使用教程
使用依赖
- Node.js (>=18.x):下载链接
- Bitbucket Cloud 账户
安装教程
- 认证:
- 生成 Bitbucket 应用密码或 Atlassian API 令牌。
- 配置凭证:
- 方法 A:编辑
~/.mcp/configs.json
文件。 - 方法 B:通过环境变量传递凭证。
- 启动服务器:
bash npx -y @aashari/mcp-server-atlassian-bitbucket
调试方式
- 使用
--help
查看命令帮助:bash mcp-atlassian-bitbucket --help
- 获取特定命令的详细帮助:
bash mcp-atlassian-bitbucket get-repository --help