Atlassian Bitbucket Server MCP

🚀 Atlassian Bitbucket MCP 服務器

Atlassian Bitbucket MCP 服務器是一個與 AI 系統集成的 Atlassian Bitbucket Server/Data Center 的 Model Context Protocol (MCP) 服務器，它能讓 AI 系統與 Bitbucket 倉庫進行交互，為開發工作提供便利。

🚀 快速開始

先決條件

• 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

✨ 主要特性

此服務器通過以下方式使 AI 系統能夠與 Bitbucket 倉庫交互：

• 訪問項目、倉庫、分支和文件
• 提供處理拉取請求的工具
• 使用官方 Bitbucket OpenAPI 規範實現類型安全的 API 集成

📦 安裝指南

使用 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

📚 詳細文檔

環境變量

📄 許可證

MIT - 有關詳細信息，請參閱 LICENSE 文件。

致謝

這個項目受到 aashari/mcp-server-atlassian-bitbucket 的啟發。