MCP Bitbucket Python 🦊

Bitbucket との連携を可能にする MCP サーバーの Python 実装です。MCP (Model Context Protocol) は、AI アプリケーションによる安全なローカルツールアクセスを実現します。サーバーは AI アプリケーションと同じマシン上でローカルに実行されます。

インストール

利用可能なツール

この 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 の資格情報を環境変数として設定する必要があります。

プロジェクト構造