MCP Bitbucket

Bitbucket統合用のMCPサーバーのPython実装で、リポジトリ管理、ブランチ操作、ファイルの読み書きなど、様々なBitbucket操作ツールを提供し、ローカルでの実行とAIアプリケーションとの安全なやり取りをサポートしています。

バージョン管理開発者ツール #Bitbucket統合 #MCPプロトコル #Pythonツール #リポジトリ管理 .Python

スコア : 2ポイント

ダウンロード数 : 16

更新時間 : 2025-04-29

MCP Bitbucket Pythonとは？

これはローカルで実行されるサーバープログラムで、AIアプリケーションが安全なプロトコルを通じてBitbucket上のコードリポジトリにアクセスし操作することを可能にします。Bitbucketとのやり取りに必要な一連のツールを提供し、リポジトリの作成、ブランチの管理、ファイルの読み書きなどができます。

MCP Bitbucket Pythonの使い方は？

まずプロジェクトをローカルにクローンし、Bitbucketの認証情報を環境変数に設定してからサーバーを起動します。AIアプリケーションはMCPプロトコルを通じてサーバーと通信し、様々なBitbucket操作を実行できます。

適用シーン

自動コード生成、リポジトリ管理、CI/CDフローの統合など、Bitbucket操作の自動化が必要なAIアプリケーション開発に適しています。

主要機能

リポジトリの作成指定されたワークスペースに新しいBitbucketコードリポジトリを作成します。

ブランチ管理コードリポジトリのブランチを作成し管理します。

ファイル操作リポジトリ内のファイルを読み書きし、削除します。

問題管理リポジトリ内の問題（Issue）を作成し削除します。

マージリクエストPull Requestを作成し管理します。

利点と制限

利点

ローカルで実行されるため、データが安全です。

完全なBitbucket APIをカバーしています。

AIアプリケーションとの統合が容易です。

細かい粒度の権限制御をサポートしています。

制限

Bitbucketの認証情報を事前に設定する必要があります。

Python環境のみをサポートしています。

一部の高度な機能にはBitbucket Premiumが必要です。

使い方

インストール

プロジェクトをローカルにクローンします。

環境変数の設定

Bitbucketのユーザー名とアプリケーションパスワードを設定します。

サーバーの起動

サーバープログラムを実行します。

使用例

自動化プロジェクトの初期化AIアプリケーションが自動的に新しいリポジトリを作成し、初期ファイルを追加します。

問題の自動報告AIがコードの問題を検出した後、自動的にIssueを作成します。

よくある質問

Bitbucketのアプリケーションパスワードを取得する方法は？

複数のワークスペースを同時に管理できますか？

ファイル操作にサイズ制限はありますか？

🚀 MCP Bitbucket Python 🦊

MCP（モデルコンテキストプロトコル）を用いた、Bitbucketとの統合を実現するPython製のサーバーです。MCPを通じて、AIアプリケーションがローカルツールに安全にアクセスできます。このサーバーはAIアプリケーションと同じマシン上でローカルに動作します。

🚀 クイックスタート

📦 インストール

# サーバーをローカルにインストール
git clone https://github.com/kallows/mcp-bitbucket.git

💻 使用例

このMCPサーバーは以下のBitbucket統合ツールを提供します。

bb_create_repository：新しいBitbucketリポジトリを作成します。
- 必須：名称（リポジトリ名）
- オプション：説明、ワークスペース（デフォルト：kallows）、プロジェクトキー、プライベートかどうか（デフォルト：true）、問題追跡の有無（デフォルト：true）
bb_create_branch：リポジトリ内に新しいブランチを作成します。
- 必須：repo_slug、ブランチ（新しいブランチ名）
- オプション：ワークスペース（デフォルト：kallows）、開始ポイント（デフォルト：メインブランチ）
bb_delete_repository：Bitbucketリポジトリを削除します。
- 必須：repo_slug
- オプション：ワークスペース（デフォルト：kallows）
bb_read_file：リポジトリからファイルを読み取ります。
- 必須：repo_slug、パス（リポジトリ内のファイルパス）
- オプション：ワークスペース（デフォルト：kallows）、ブランチ（デフォルト：メイン/メインブランチ）
bb_write_file：リポジトリ内のファイルを作成または更新します。
- 必須：repo_slug、パス、内容
- オプション：ワークスペース（デフォルト：kallows）、ブランチ（デフォルト：メインブランチ）、メッセージ（コミット情報）
bb_create_issue：リポジトリ内に問題を作成します。
- 必須：repo_slug、タイトル、内容
- オプション：ワークスペース（デフォルト：kallows）、タイプ（bug/enhancement/proposal/task）、優先度（trivial/minor/major/critical/blocker）
bb_delete_issue：リポジトリ内の問題を削除します。
- 必須：repo_slug、問題ID
- オプション：ワークスペース（デフォルト：kallows）
bb_search_repositories：クエリ構文を使用してBitbucketリポジトリを検索します。
- 必須：クエリ（例：'name ~ "test"' または 'project.key = "PROJ"')
- オプション：ワークスペース（デフォルト：kallows）、ページ番号（デフォルト：1）、1ページあたりの長さ（デフォルト：10、最大：100）
bb_delete_file：リポジトリ内のファイルを削除します。
- 必須：repo_slug、パス
- オプション：ワークスペース（デフォルト：kallows）、ブランチ（デフォルト：メインブランチ）、メッセージ（コミット情報）
bb_create_pull_request：プルリクエストを作成します。
- 必須：repo_slug、タイトル、ソースブランチ
- オプション：ワークスペース（デフォルト：kallows）、ターゲットブランチ（デフォルト：メインブランチ）、説明、ソースブランチを閉じるかどうか（デフォルト：true）

🔧 環境設定

サーバーを動作させるには、Bitbucketの認証情報を環境変数として設定する必要があります。

export BITBUCKET_USERNAME="your-username"
export BITBUCKET_APP_PASSWORD="your-app-password"

📚 ドキュメント

プロジェクト構造

mcp-bitbucket/
├── README.md
├── pyproject.toml
├── src/
│   └── bitbucket_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_bb_api.py
    └── test_bb_integration.py