MCP Bitbucket Python 🦊
Bitbucket との連携を可能にする MCP サーバーの Python 実装です。MCP (Model Context Protocol) は、AI アプリケーションによる安全なローカルツールアクセスを実現します。サーバーは AI アプリケーションと同じマシン上でローカルに実行されます。
インストール
# Install the server locally
git clone https://github.com/kallows/mcp-bitbucket.git
利用可能なツール
この MCP サーバーは、次の Bitbucket 統合ツールを提供します。
bb_create_repository
: 新しい Bitbucket リポジトリを作成する- 必須: 名前 (リポジトリ名)
- オプション: 説明、ワークスペース (デフォルトは kallows)、プロジェクトキー、is_private (デフォルト: true)、has_issues (デフォルト: true)
bb_create_branch
: リポジトリに新しいブランチを作成する- 必須: repo_slug、branch(新しいブランチの名前)
- オプション: ワークスペース (デフォルトは kallows)、start_point (デフォルトは main)
bb_delete_repository
: Bitbucket リポジトリを削除する- 必須: repo_slug
- オプション: ワークスペース (デフォルトは kallows)
bb_read_file
: リポジトリからファイルを読み取る- 必須: repo_slug、path (リポジトリ内のファイルパス)
- オプション: ワークスペース (デフォルトは kallows)、ブランチ (デフォルトは main/master)
bb_write_file
: リポジトリ内のファイルを作成または更新する- 必須: repo_slug、パス、コンテンツ
- オプション: ワークスペース (デフォルトは kallows)、ブランチ (デフォルトは main)、メッセージ (コミットメッセージ)
bb_create_issue
: リポジトリに問題を作成する- 必須: repo_slug、タイトル、コンテンツ
- オプション: ワークスペース (デフォルトは kallows)、種類 (バグ/機能強化/提案/タスク)、優先度 (些細/軽微/重大/重大/ブロック)
bb_delete_issue
: リポジトリから問題を削除する- 必須: repo_slug、issue_id
- オプション: ワークスペース (デフォルトは kallows)
bb_search_repositories
: クエリ構文を使用して Bitbucket リポジトリを検索します- 必須: クエリ (例: 'name ~ "test"' または 'project.key = "PROJ"')
- オプション: ワークスペース (デフォルトは kallows)、ページ (デフォルト: 1)、ページ長 (デフォルト: 10、最大: 100)
bb_delete_file
: リポジトリからファイルを削除する- 必須: repo_slug、パス
- オプション: ワークスペース (デフォルトは kallows)、ブランチ (デフォルトは main)、メッセージ (コミットメッセージ)
bb_create_pull_request
: プルリクエストを作成する- 必須: repo_slug、title、source_branch
- オプション: ワークスペース (デフォルトは kallows)、 destination_branch (デフォルトは main)、 description、 close_source_branch (デフォルト: 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