mcp-server-atlassian-bitbucket

Atlassian Bitbucket MCP Server

本项目提供了一个 Model Context Protocol (MCP) 服务器，作为 AI 助手（如 Anthropic 的 Claude、Cursor AI 或其他 MCP 兼容客户端）与您的 Atlassian Bitbucket 实例之间的桥梁。它允许 AI 安全地实时访问和交互您的仓库、拉取请求和工作区。

概述

什么是 MCP？

Model Context Protocol (MCP) 是一种开放标准，允许 AI 系统安全且上下文相关地连接外部工具和数据源。

该服务器专门为 Bitbucket Cloud 实现 MCP，将您的 Bitbucket 数据与 AI 助手连接起来。

为什么使用此服务器？

最小输入，最大输出哲学：只需简单的标识符，如 workspaceSlug 和 repoSlug。每个工具都会返回全面的详细信息，无需额外的标志。

丰富的代码可视化：通过文件统计、差异视图和代码修改的智能上下文，获取仓库和代码变更的详细洞察。

安全的本地身份验证：凭据不会存储在服务器中。服务器在本地运行，因此您的令牌永远不会离开您的机器，您可以仅请求所需的权限。

直观的 Markdown 响应：所有响应都使用结构良好的 Markdown，以提高可读性，并具有一致的格式和导航链接。

完整的 Bitbucket 集成：通过统一的界面访问工作区、仓库、拉取请求、评论、代码搜索等。

快速开始

先决条件

Node.js (>=18.x)：下载

Bitbucket Cloud 账户

第一步：身份验证

选择以下身份验证方法之一：

选项 A：Bitbucket 应用密码（推荐）

从 Bitbucket 应用密码生成。最低权限：

工作区：读取

仓库：读取

拉取请求：读取

选项 B：Atlassian API 令牌

从 Atlassian API 令牌生成。

第二步：配置凭据

方法 A：MCP 配置文件（推荐）

创建或编辑 ~/.mcp/configs.json：

使用 Bitbucket 应用密码：

使用 Atlassian API 令牌：

注意： 为了向后兼容，服务器还将识别完整包名（@aashari/mcp-server-atlassian-bitbucket）、无作用域包名（mcp-server-atlassian-bitbucket）或 atlassian-bitbucket 格式的配置，如果未找到推荐的 bitbucket 键。然而，对于新配置，建议使用简短的 bitbucket 键。

方法 B：环境变量

在运行服务器时直接传递凭据：

第三步：连接您的 AI 助手

配置您的 MCP 兼容客户端以启动此服务器。

Claude / Cursor 配置：

此配置将在运行时自动启动服务器。

工具

本节介绍与 AI 助手一起使用此服务器时可用的 MCP 工具。请注意，MCP 工具使用 snake_case 作为工具名称，使用 camelCase 作为参数。

`bb_ls_workspaces`

列出可用的 Bitbucket 工作区。

或：

"显示我所有的 Bitbucket 工作区。"

`bb_get_workspace`

获取特定工作区的完整详细信息。

"告诉我更多关于 'acme-corp' 工作区的信息。"

`bb_ls_repos`

列出工作区中的仓库。

或：

"列出 'acme-corp' 中的仓库。"

`bb_get_repo`

获取特定仓库的详细信息。

"显示 'acme-corp' 中的 'backend-api' 仓库。"

`bb_search`

搜索 Bitbucket 内容。

仓库：

拉取请求：

提交：

代码：

"在 'acme-corp' 工作区中搜索 'function getUser'。"

`bb_ls_prs`

列出仓库中的拉取请求。

"显示 'frontend-app' 中的开放 PR。"

`bb_get_pr`

获取拉取请求的完整详细信息，包括代码差异和文件更改。

"获取 'frontend-app' 中的 PR #42 及其所有代码更改。"

`bb_ls_pr_comments`

列出特定拉取请求的评论。

"显示 PR #42 上的所有评论。"

`bb_create_pr_comment`

向拉取请求添加评论。

常规：

内联：

"在 PR #42 的第 42 行添加评论。"

`bb_create_pr`

创建一个新的拉取请求。

"从 'feature/login' 到 'main' 创建一个 PR。"

命令行界面 (CLI)

CLI 使用 kebab-case 作为命令（例如 ls-workspaces）和选项（例如 --workspace-slug）。

使用 `npx` 快速使用

全局安装

然后直接运行：

发现更多 CLI 选项

使用 --help 查看所有可用命令的标志和用法：

或获取特定命令的详细帮助：

许可证

ISC 许可证