Garc33 Bitbucket Server MCP Server

🚀 Bitbucket サーバ MCP

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

🚀 クイックスタート

このサーバを使用するには、まず必要な環境を整え、インストールと構築を行います。

✨ 主な機能

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

create_pull_request

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

パラメータ:

• project（必須）：Bitbucket のプロジェクトキー
• repository（必須）：リポジトリのエイリアス
• title（必須）：PR のタイトル
• description：PR の説明
• sourceBranch（必須）：ソースブランチの名前
• targetBranch（必須）：ターゲットブランチの名前
• reviewers：レビュアーのユーザー名の配列

get_pull_request

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

パラメータ:

• project（必須）：Bitbucket のプロジェクトキー
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエストの ID

merge_pull_request

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

パラメータ:

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

decline_pull_request

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

パラメータ:

• project（必須）：Bitbucket のプロジェクトキー
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエストの ID
• message：拒否の理由

add_comment

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

パラメータ:

• project（必須）：Bitbucket のプロジェクトキー
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエストの ID
• text（必須）：コメントのテキスト
• parentId：返信先の親コメントの ID

get_diff

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

パラメータ:

• project（必須）：Bitbucket のプロジェクトキー
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエストの ID
• contextLines：コンテキスト行数（デフォルト：10）

get_reviews

プルリクエストのレビュー履歴（承認とコメントを含む）を取得します。

パラメータ:

• project（必須）：Bitbucket のプロジェクトキー
• repository（必須）：リポジトリのエイリアス
• prId（必須）：プルリクエストの ID

📦 インストール

必要条件

• Node.js >= 16

インストールコマンド

npm install

🛠️ 構築

npm run build

📚 ドキュメント

依存関係

• @modelcontextprotocol/sdk - MCP プロトコルを実装した SDK
• axios - API リクエスト用の HTTP クライアント
• winston - ログフレームワーク

設定

サーバは、VSCode MCP 設定ファイルで設定する必要があります。以下は設定例です。

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/path/to/bitbucket-server/build/index.js"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        // 認証（いずれか 1 つを選択）：
        // オプション 1：個人用アクセストークン
        "BITBUCKET_TOKEN": "your-access-token",
        // オプション 2：ユーザー名/パスワード
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-password"
      }
    }
  }
}

環境変数

• BITBUCKET_URL（必須）：Bitbucket Server インスタンスのベース URL
• 認証（以下のいずれかが必須）：
  • BITBUCKET_TOKEN：個人用アクセストークン
  • BITBUCKET_USERNAME と BITBUCKET_PASSWORD：基本認証の資格情報

ログ記録

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