Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP Server

site icon
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 协作的效率。

核心功能

  • 最小输入,最大输出:仅需简单的标识符(如 workspaceSlugrepoSlug)即可获取全面的信息。
  • 丰富的代码可视化:提供文件统计、差异视图和代码修改的智能上下文。
  • 安全的本地认证:凭证不存储在服务器中,仅在本地运行,确保数据安全。
  • 直观的 Markdown 响应:所有响应均使用结构化的 Markdown 格式,便于阅读和导航。
  • 完整的 Bitbucket 集成:支持访问工作区、仓库、拉取请求、评论、代码搜索等功能。

适用场景

  • 团队协作:AI 助手协助管理代码仓库、拉取请求和评论。
  • 代码审查:通过 AI 快速获取代码变更的详细视图和上下文。
  • 自动化任务:AI 自动创建拉取请求或搜索代码片段。

工具列表

  1. list_workspaces:列出可用的 Bitbucket 工作区。
  2. get_workspace:获取特定工作区的详细信息。
  3. list_repositories:列出工作区中的仓库。
  4. get_repository:获取特定仓库的详细信息。
  5. search:搜索 Bitbucket 内容(仓库、拉取请求、提交、代码)。
  6. list_pull_requests:列出仓库中的拉取请求。
  7. get_pull_request:获取拉取请求的详细信息(包括代码差异)。
  8. list_pr_comments:列出拉取请求的评论。
  9. add_pr_comment:向拉取请求添加评论(支持行内评论)。
  10. pull_requests_create:创建新的拉取请求。

常见问题解答

  • 如何认证?:支持 Bitbucket 应用密码或 Atlassian API 令牌。
  • 凭证存储在哪里?:凭证仅存储在本地配置文件中或通过环境变量传递,不保存在服务器中。
  • 如何启动服务器?:通过 npx 或全局安装后直接运行。

使用教程

使用依赖

安装教程

  1. 认证
  2. 生成 Bitbucket 应用密码或 Atlassian API 令牌。
  3. 配置凭证
  4. 方法 A:编辑 ~/.mcp/configs.json 文件。
  5. 方法 B:通过环境变量传递凭证。
  6. 启动服务器bash npx -y @aashari/mcp-server-atlassian-bitbucket

调试方式

  • 使用 --help 查看命令帮助: bash mcp-atlassian-bitbucket --help
  • 获取特定命令的详细帮助: bash mcp-atlassian-bitbucket get-repository --help

许可证

该项目遵循 ISC 开源许可条款。