Atlassian Bitbucket MCP 服务器

一个与 AI 系统集成的 Atlassian Bitbucket Server/Data Center 的 Model Context Protocol (MCP) 服务器。

功能概述

此服务器通过以下方式使 AI 系统能够与 Bitbucket 仓库交互：

• 访问项目、仓库、分支和文件
• 提供处理拉取请求的工具
• 使用官方 Bitbucket OpenAPI 规范实现类型安全的 API 集成

快速设置

先决条件

• Node.js (推荐 v20+)
• npm
• Python 3（用于 OpenAPI 过滤脚本）
• Bitbucket Server 访问令牌

安装

git clone [<atlassian-bitbucket-server-mcp>](https://github.com/guenichone/atlassian-bitbucket-server-mcp)  
cd mcp-server-selfhosted-bitbucket  
npm install  
npm run build-app

运行服务器

# 作为 STDIO 服务器（AI 集成的默认选项）
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \  
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \  
npm start  

# 作为 HTTP/SSE 服务器
MCP_TRANSPORT=sse \  
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \  
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \  
npm start

Docker 使用

使用 Docker CLI

# 构建
docker build -t bitbucket-mcp-server .  

# 运行
docker run --rm -i \  
  -e ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \  
  -e ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \  
  bitbucket-mcp-server

使用 Makefile（推荐）

该项目包含一个 Makefile，用于简化 Docker 操作：

# 构建 Docker 镜像
make docker-build  

# 使用你的 Bitbucket 凭据运行
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-run  

# 一次构建并运行
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-all  

# 查看所有可用的 Make 命令和示例
make help

环境变量

• ATLASSIAN_BITBUCKET_SERVER_URL - Bitbucket 服务器 URL
• ATLASSIAN_BITBUCKET_ACCESS_TOKEN - 你的访问令牌
• MCP_TRANSPORT - stdio（默认）或 sse
• PORT - 使用 SSE 时的 HTTP 端口（默认：3000）

致谢

这个项目受到 aashari/mcp-server-atlassian-bitbucket 的启发。

许可证

MIT - 有关详细信息，请参阅 LICENSE 文件。