Atlassian Bitbucket Server MCP

🚀 Atlassian Bitbucket MCP サーバー

Atlassian Bitbucket Server/Data Center と AI システムを統合するための Model Context Protocol (MCP) サーバーです。このサーバーを使うことで、AI システムが Bitbucket リポジトリと相互作用できるようになります。

✨ 主な機能

このサーバーは、以下の方法で 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 を使用する場合（推奨）

このプロジェクトには、Docker 操作を簡素化するための Makefile が含まれています。

# 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

📚 環境変数

🙏 謝辞

このプロジェクトは、aashari/mcp-server-atlassian-bitbucket からインスピレーションを得ています。

📄 ライセンス

MIT - 詳細については、LICENSE ファイルを参照してください。