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

Related MCP server: Model Context Protocol (MCP) Server

利用可能なツール

この 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