ビットバケットMCP
Bitbucket CloudおよびServer APIと統合するためのModel Context Protocol(MCP)サーバー。このMCPサーバーにより、CursorなどのAIアシスタントがBitbucketリポジトリ、プルリクエスト、その他のリソースと連携できるようになります。
安全第一
これは安全で責任あるパッケージです。DELETE操作は使用されないため、データ損失のリスクはありません。すべてのプルリクエストはCodeQLで分析され、コードの安全性が確保されています。
Related MCP server: GitHub MCP Server
概要
公式npmパッケージをチェックアウトしてください。このサーバーは、モデルコンテキストプロトコル標準を実装し、AIアシスタントにBitbucketのデータと操作へのアクセスを提供します。以下のツールが含まれています。
リポジトリの一覧表示と取得
リポジトリの詳細を取得する
プルリクエストの取得
さらに…
インストール
NPXの使用(推奨)
この MCP サーバーを使用する最も簡単な方法は NPX を使用することです。これにより、グローバルにインストールせずに実行できます。
手動インストール
あるいは、グローバルにインストールすることも、プロジェクトの一部としてインストールすることもできます。
次に次のコマンドで実行します:
構成
環境変数
次の環境変数を使用してサーバーを構成します。
変数 | 説明 | 必須 |
| Bitbucket ベース URL (例: " https://bitbucket.org/your-workspace ") | はい |
| Bitbucketユーザー名 | はい* |
| Bitbucket アプリのパスワード | はい* |
| Bitbucket アクセス トークン (ユーザー名/パスワードの代替) | いいえ |
| 指定されていない場合に使用するデフォルトのワークスペース | いいえ |
* BITBUCKET_TOKENいずれか、またはBITBUCKET_USERNAMEとBITBUCKET_PASSWORDの両方を指定する必要があります。
Bitbucket アプリのパスワードを作成する
Bitbucketアカウントにログインする
個人設定 > アプリパスワードに移動します
次の権限を持つ新しいアプリ パスワードを作成します。
リポジトリ: 読む
プルリクエスト: 読み取り、書き込み
生成されたパスワードをコピーし、
BITBUCKET_PASSWORD環境変数として使用します。
カーソルとの統合
この MCP サーバーを Cursor と統合するには:
オープンカーソル
設定 > 拡張機能に移動します
「モデルコンテキストプロトコル」をクリックします
新しい MCP 構成を追加します。
設定を保存する
Cursor の「/bitbucket」コマンドを使用して、Bitbucket リポジトリとプルリクエストにアクセスします。
カーソルを使ったローカルビルドの使用
ローカルで開発していて、変更をテストしたい場合は、次の手順を実行します。
利用可能なツール
このMCPサーバーは、Bitbucketリポジトリやプルリクエストを操作するためのツールを提供します。利用可能な操作の包括的なリストを以下に示します。
リポジトリ操作
listRepositories
ワークスペース内のリポジトリを一覧表示します。
パラメータ:
workspace(オプション): Bitbucket ワークスペース名limit(オプション): 返されるリポジトリの最大数
getRepository
特定のリポジトリの詳細を取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグ
プルリクエスト操作
getPullRequests
リポジトリのプル リクエストを取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグstate(オプション): プルリクエストの状態 (OPEN、MERGED、DECLINED、SUPERSEDED)limit(オプション): 返されるプルリクエストの最大数
createPullRequest
新しいプル リクエストを作成します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグtitle: プルリクエストのタイトルdescription: プルリクエストの説明sourceBranch: ソースブランチ名targetBranch: ターゲットブランチ名reviewers(オプション): レビュー担当者のユーザー名のリスト
getPullRequest
特定のプル リクエストの詳細を取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
updatePullRequest
プル リクエストを更新します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDさまざまなオプションの更新パラメータ(タイトル、説明など)
getPullRequestActivity
プル リクエストのアクティビティ ログを取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
approvePullRequest
プル リクエストを承認します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
unapprovePullRequest
プル リクエストから承認を削除します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
declinePullRequest
プルリクエストを拒否します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDmessage(オプション): 辞退の理由
mergePullRequest
プル リクエストをマージします。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDmessage(オプション): マージコミットメッセージstrategy(オプション): マージ戦略 (merge-commit、squash、fast-forward)
requestChanges
プル リクエストの変更をリクエストします。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
removeChangeRequest
プル リクエストから変更リクエストを削除します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
プルリクエストコメント操作
getPullRequestComments
プル リクエストのコメントを一覧表示します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
createPullRequestComment
プル リクエストにコメントを作成します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDcontent: コメント内容inline(オプション): インラインコメント情報
getPullRequestComment
プル リクエストに対する特定のコメントを取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDcomment_id: コメントID
updatePullRequestComment
プル リクエストのコメントを更新します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDcomment_id: コメントIDcontent: コメント内容を更新しました
deletePullRequestComment
プル リクエストのコメントを削除します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDcomment_id: コメントID
resolveComment
プル リクエストのコメント スレッドを解決します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDcomment_id: コメントID
reopenComment
プル リクエストの解決済みのコメント スレッドを再度開きます。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDcomment_id: コメントID
プルリクエストの差分操作
getPullRequestDiff
プル リクエストの diff を取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
getPullRequestDiffStat
プル リクエストの diff 統計を取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
getPullRequestPatch
プル リクエストのパッチを取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
プルリクエストタスク操作
getPullRequestTasks
プル リクエストのタスクを一覧表示します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
createPullRequestTask
プル リクエストにタスクを作成します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDcontent: タスクの内容comment(オプション): タスクに関連付けるコメントIDpending(オプション):タスクが保留中かどうか
getPullRequestTask
プル リクエストの特定のタスクを取得します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDtask_id: タスクID
updatePullRequestTask
プル リクエストのタスクを更新します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDtask_id: タスクIDcontent(オプション): 更新されたタスクコンテンツstate(オプション): 更新されたタスクの状態
deletePullRequestTask
プル リクエストのタスクを削除します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストIDtask_id: タスクID
その他のプルリクエスト操作
getPullRequestCommits
プル リクエストのコミットを一覧表示します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
getPullRequestStatuses
プル リクエストのコミット ステータスを一覧表示します。
パラメータ:
workspace: Bitbucket ワークスペース名repo_slug: リポジトリのスラッグpull_request_id: プルリクエストID
発達
前提条件
Node.js 18以上
npmまたはyarn
設定
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。