Bitbucket Server MCP Server

🚀 Bitbucket サーバ MCP

MCP（モデルコンテキストプロトコル）サーバは、Bitbucket サーバ上のプルリクエストを管理するために使用されます。このサーバは、MCP プロトコルを介して Bitbucket サーバ API とやり取りするためのツールとリソースを提供します。

🚀 クイックスタート

MCP（モデルコンテキストプロトコル）サーバは、Bitbucket サーバ上のプルリクエストを管理するために使用されます。このサーバは、MCP プロトコルを介して Bitbucket サーバ API とやり取りするためのツールとリソースを提供します。

✨ 主な機能

このサーバは、Bitbucket サーバとの統合に必要な以下のツールを提供します。

create_pull_request

新しいプルリクエストを作成します。

パラメータ：

• project：Bitbucket プロジェクトキー（BITBUCKET_DEFAULT_PROJECT が設定されている場合はそれがデフォルト）
• repository（必須）：リポジトリのエイリアス
• title（必須）：PR のタイトル
• description：PR の説明
• sourceBranch（必須）：ソースブランチ名
• targetBranch（必須）：ターゲットブランチ名
• reviewers：レビュアーのユーザー名の配列

get_pull_request

特定のプルリクエストの詳細情報を取得します。

パラメータ：

• project：Bitbucket プロジェクトキー（BITBUCKET_DEFAULT_PROJECT が設定されている場合はそれがデフォルト）
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエスト ID

merge_pull_request

プルリクエストをマージします。

パラメータ：

• project：Bitbucket プロジェクトキー（BITBUCKET_DEFAULT_PROJECT が設定されている場合はそれがデフォルト）
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエスト ID
• message：マージコミットメッセージ
• strategy：以下のいずれか
  • merge-commit（デフォルト）
  • squash
  • fast-forward

decline_pull_request

プルリクエストを拒否します。

パラメータ：

• project：Bitbucket プロジェクトキー（BITBUCKET_DEFAULT_PROJECT が設定されている場合はそれがデフォルト）
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエスト ID
• message：拒否理由

add_comment

プルリクエストにコメントを追加します。

パラメータ：

• project：Bitbucket プロジェクトキー（BITBUCKET_DEFAULT_PROJECT が設定されている場合はそれがデフォルト）
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエスト ID
• text（必須）：コメントテキスト
• parentId：返信先の親コメントの ID

get_diff

プルリクエストの差分を取得します。

パラメータ：

• project：Bitbucket プロジェクトキー（BITBUCKET_DEFAULT_PROJECT が設定されている場合はそれがデフォルト）
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエスト ID

📦 インストール

Smithery を通じたインストール

Claude デスクトップで使用するために Bitbucket サーバを自動インストールするには、Smithery を通じて以下のコマンドを実行します。

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

手動インストール

npm install

📚 ドキュメント

ビルド

npm run build

サードパーティライブラリ

このサーバは、以下のサードパーティライブラリに依存しています。

• @smithery/cli - Smithery の CLI ツールで、ツールのインストールと管理に使用されます。
• axios - Promise ベースの HTTP クライアント
• winston - 軽量のロギングライブラリ

設定

環境変数

このサーバは、以下の環境変数を使用します。

• BITBUCKET_SERVER_URL：Bitbucket サーバの URL アドレス（デフォルトは http://localhost:7990）
• BITBUCKET_USERNAME と BITBUCKET_PASSWORD：認証に使用するユーザー名とパスワード
• BITBUCKET_DEFAULT_PROJECT：指定されていない場合に使用されるデフォルトのプロジェクトキー

ロギング

このサーバは、すべての操作を bitbucket.log に記録し、Winston を使用してデバッグと監視を行います。