使用说明

项目简介

Bitbucket MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在连接 AI 助手（如 Claude、Cursor AI 等 MCP 客户端）和 Atlassian Bitbucket 云平台。它允许 AI 助手安全、实时地访问和操作您的 Bitbucket 仓库、拉取请求和工作空间，无需手动复制粘贴数据，提升 AI 在代码分析、代码审查和上下文理解等方面的能力。

主要功能点

实时访问 Bitbucket 数据: AI 助手可以直接访问最新的 Bitbucket 仓库、拉取请求等信息。
工具集成: 提供一系列预定义的工具，例如：
- 'list-workspaces': 列出您有权访问的 Bitbucket 工作空间。
- 'get-workspace': 获取特定工作空间的详细信息。
- 'list-repositories': 列出工作空间中的代码仓库。
- 'get-repository': 获取特定代码仓库的详细信息。
- 'list-pull-requests': 列出代码仓库中的拉取请求。
- 'get-pull-request': 获取特定拉取请求的详细信息。
安全访问控制: 通过 API 凭证（Atlassian API Token 或 Bitbucket 应用密码）控制 AI 助手的访问权限，保障数据安全。
简易接口，丰富输出: 工具设计简洁易用，只需提供必要的标识符即可获取详细的 Bitbucket 信息。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js (包含 npm)。
获取 Bitbucket 凭证:
- 选项 A: Bitbucket 应用密码 (推荐) - 访问 Bitbucket 应用密码设置创建应用密码，并授予 'Workspaces' (读取), 'Repositories' (读取), 'Pull requests' (读取) 权限。
- 选项 B: Atlassian API Token - 访问 Atlassian API Token 管理创建 API Token，并复制 Token。

配置服务器凭证:

方法 A: 全局 MCP 配置文件 (推荐) - 创建或编辑 '~/.mcp/configs.json' 文件，并添加以下 JSON 配置（选择一种认证方式，替换占位符）：

{
	"@aashari/mcp-server-atlassian-bitbucket": {
		"environments": {
			"ATLASSIAN_BITBUCKET_USERNAME": "<YOUR_BITBUCKET_USERNAME>",
			"ATLASSIAN_BITBUCKET_APP_PASSWORD": "<YOUR_COPIED_APP_PASSWORD>"
		}
	}
}

或

{
	"@aashari/mcp-server-atlassian-bitbucket": {
		"environments": {
			"ATLASSIAN_SITE_NAME": "<ANY_VALUE_LIKE_bitbucket>",
			"ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>",
			"ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>"
		}
	}
}

方法 B: 环境变量 - 在运行服务器时设置环境变量（选择一种认证方式，替换占位符）：

ATLASSIAN_BITBUCKET_USERNAME="<YOUR_USERNAME>" ATLASSIAN_BITBUCKET_APP_PASSWORD="<YOUR_APP_PASSWORD>" npx -y @aashari/mcp-server-atlassian-bitbucket

或

ATLASSIAN_SITE_NAME="bitbucket" ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>" npx -y @aashari/mcp-server-atlassian-bitbucket

启动 MCP 服务器: 在终端运行命令 'npx -y @aashari/mcp-server-atlassian-bitbucket'。

服务器配置

对于 MCP 客户端 (如 Claude Desktop, Cursor AI)，您需要配置 MCP 服务器的启动命令。以下是配置示例，请根据您的 MCP 客户端进行配置：

Claude Desktop 配置 (config.json):

{
	"mcpServers": {
		"aashari/mcp-server-atlassian-bitbucket": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
		}
	}
}

'server name': 'aashari/mcp-server-atlassian-bitbucket' (服务器名称，用于客户端识别)
'command': 'npx' (启动命令，通常为 npx 或 node)
'args': '["-y", "@aashari/mcp-server-atlassian-bitbucket"]' (命令参数，指定要运行的 npm 包)

Cursor AI 配置 (Settings > MCP):

{
    "servers": [
        {
            "name": "aashari/mcp-server-atlassian-bitbucket",
            "type": "command",
            "command": "npx -y @aashari/mcp-server-atlassian-bitbucket"
        }
    ]
}

'Name': 'aashari/mcp-server-atlassian-bitbucket' (服务器名称)
'Type': 'command' (服务器类型)
'Command': 'npx -y @aashari/mcp-server-atlassian-bitbucket' (启动命令)

基本使用方法

启动 MCP 服务器后，配置您的 MCP 客户端连接到该服务器。
在 AI 助手中使用自然语言指令调用 Bitbucket 工具，例如：
- "列出我的 Bitbucket 工作空间"
- "显示 'dev-team' 工作空间中的所有仓库"
- "获取 'acme-corp/backend-api' 仓库的详细信息"
- "展示 'acme-corp/frontend-app' 仓库的未解决拉取请求"
- "总结 'acme-corp/frontend-app' 仓库中编号为 #42 的拉取请求"
服务器会将 Bitbucket 的信息以 Markdown 格式返回给 AI 助手。

您也可以使用命令行工具直接与服务器交互，例如：

'npx -y @aashari/mcp-server-atlassian-bitbucket list-workspaces'
'npx -y @aashari/mcp-server-atlassian-bitbucket get-repository --workspace my-team --repository my-api'

关键词