Bitbucket MCP 服务器

此仓库包含用于 Bitbucket Cloud 集成的模型上下文协议（MCP）服务器实现。

可用的 MCP 工具有：

• list_pull_open_requests：获取 Bitbucket 仓库中的所有打开的拉取请求。
• get_pull_request_comments：获取特定拉取请求的评论。

项目

• BitbucketRemoteMcpServer：基于 ASP.NET Web API 的 MCP 服务器，适用于服务器安装（流式 HTTP 或 SSE 传输）
• BitbucketMcpServer：基于控制台的 MCP 服务器，适用于本地工作站安装（标准 I/O 传输）

通过 Docker 和 Linux 服务器运行（推荐）

1. 在你的 Linux 服务器上创建配置目录：

   mkdir -p /opt/bitbucket-mcp-server
   cd /opt/bitbucket-mcp-server
   

2. 拉取 Docker 镜像：

   docker pull peakflames/bitbucket-remote-mcp-server
   

3. 创建一个针对你的 Bitbucket 配置的 appsettings.json 文件：

   {
     "BitbucketCloudConfig": {
       "AccountName": "your-workspace-name",
       "Username": "OBTAIN_FROM_ENV_VAR_BITBUCKET_MCP_USERNAME",
       "AppPassword": "OBTAIN_FROM_ENV_VAR_BITBUCKET_MCP_API_TOKEN"
     }
   }
   

4. 运行 Docker 容器：

   docker run -d \
     --name bitbucket-mcp-server \
     -p 8080:8080 \
     -e BITBUCKET_MCP_USERNAME="your_bitbucket_username" \
     -e BITBUCKET_MCP_API_TOKEN="your_bitbucket_app_password" \
     -v $(pwd)/appsettings.json:/app/appsettings.json \
     peakflames/bitbucket-remote-mcp-server
   

5. 服务器现在应该已经启动。MCP 客户端将使用以下方式连接：

   • 流式 HTTP 传输：http://{{your-server-ip}}:8080/
   • SSE 传输：http://{{your-server-ip}}:8080/sse

配置选项 (appsettings.json)

服务器使用 appsettings.json 进行配置，其中包含一组可以访问你 Bitbucket 账户中任何仓库的凭据。

设置	描述	必需	默认值
AccountName	Bitbucket 工作区/账户名称	是	N/A
Username	表示哪个环境变量包含用户名的占位符	是	N/A
AppPassword	表示哪个环境变量包含应用密码的占位符	是	N/A

环境变量

你需要设置以下环境变量：

Linux/macOS:

export BITBUCKET_MCP_USERNAME="your_username"
export BITBUCKET_MCP_API_TOKEN="your_app_password"

Windows (PowerShell):

$env:BITBUCKET_MCP_USERNAME = "your_username"
$env:BITBUCKET_MCP_API_TOKEN = "your_app_password"

Windows (命令提示符):

set BITBUCKET_MCP_USERNAME=your_username
set BITBUCKET_MCP_API_TOKEN=your_app_password

工作原理

1. 配置加载：应用程序启动时从 appsettings.json 加载配置
2. 环境变量解析：敏感凭证从环境变量中解析
3. 工具调用：当调用 MCP 工具时，将仓库名称作为函数参数传递
4. 客户端创建：使用配置的凭证和工具参数中的仓库 slug 创建 Bitbucket 客户端

配置 MCP 客户端

Cline 配置

1. 打开 Cline 的 MCP 设置界面

2. 点击“远程服务器”标签

3. 添加以下配置：

   {
     "mcpServers": {
       "Bitbucket": {
         "autoApprove": [],
         "disabled": false,
         "timeout": 60,
         "url": "http://{{your-server-ip}}:8080/sse",
         "transportType": "sse"
       }
     }
   }
   

远程服务器故障排除

“环境变量未设置”错误：

• 确保在启动应用程序之前设置了 BITBUCKET_MCP_USERNAME 和 BITBUCKET_MCP_API_TOKEN 环境变量
• 检查 appsettings.json 中的环境变量名称是否与实际环境变量名称匹配

连接错误：

• 确认你的 Bitbucket 凭证正确
• 确保应用密码具有访问你正在访问的仓库所需的权限
• 检查配置中的账户名称是否正确
• 确认传递给工具的仓库名称与账户中的实际仓库匹配

权限错误：

• 确保你的应用密码具有访问所需的所有仓库的权限
• 检查你的 Bitbucket 用户是否有访问指定仓库的权限
• 确认应用密码具有必要的范围（例如，拉取请求读写）

贡献

有关开发设置、构建说明、Docker 容器发布和调试信息，请参阅 CONTRIBUTING.md。

许可证

详情请参阅 LICENSE。