Bitbucket Server MCP

Bitbucket Server MCP

Bitbucket Server のプルリクエスト管理用 MCP（Model Context Protocol）サーバーです。このサーバーは、MCP プロトコルを通じて Bitbucket Server API と連携するためのツールとリソースを提供します。

要件

• Node.js >= 16

インストール

Smithery 経由でインストール

Smithery 経由で、Claude Desktop 用の Bitbucket Server を自動的にインストールするには：

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

手動インストール

npm install

ビルド

npm run build

機能

このサーバーは、Bitbucket Server との連携に次のツールを提供します：

create_pull_request

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

パラメーター：

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

get_pull_request

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

パラメーター：

• project：Bitbucket プロジェクトキー（設定されている場合、デフォルトで BITBUCKET_DEFAULT_PROJECT が使用されます）
• repository：リポジトリのスラッグ（設定されている場合、デフォルトで BITBUCKET_DEFAULT_REPOSITORY が使用されます）
• prId（必須）：プルリクエスト ID

merge_pull_request

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

パラメーター：

• project：Bitbucket プロジェクトキー（設定されている場合、デフォルトで BITBUCKET_DEFAULT_PROJECT が使用されます）
• repository：リポジトリのスラッグ（設定されている場合、デフォルトで BITBUCKET_DEFAULT_REPOSITORY が使用されます）
• prId（必須）：プルリクエスト ID
• message：マージコミットメッセージ
• strategy：次のいずれか：
  • merge-commit（デフォルト）
  • squash
  • fast-forward

decline_pull_request

プルリクエストを却下します。

パラメーター：

• project：Bitbucket プロジェクトキー（設定されている場合、デフォルトで BITBUCKET_DEFAULT_PROJECT が使用されます）
• repository：リポジトリのスラッグ（設定されている場合、デフォルトで BITBUCKET_DEFAULT_REPOSITORY が使用されます）
• prId（必須）：プルリクエスト ID
• message：却下する理由

add_comment

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

パラメーター：

• project：Bitbucket プロジェクトキー（設定されている場合、デフォルトで BITBUCKET_DEFAULT_PROJECT が使用されます）
• repository：リポジトリのスラッグ（設定されている場合、デフォルトで BITBUCKET_DEFAULT_REPOSITORY が使用されます）
• prId（必須）：プルリクエスト ID
• text（必須）：コメント本文
• parentId：返信先の親コメント ID

get_diff

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

パラメーター：

• project：Bitbucket プロジェクトキー（設定されている場合、デフォルトで BITBUCKET_DEFAULT_PROJECT が使用されます）
• repository：リポジトリのスラッグ（設定されている場合、デフォルトで BITBUCKET_DEFAULT_REPOSITORY が使用されます）
• prId（必須）：プルリクエスト ID
• contextLines：コンテキスト行数（デフォルト：10）

get_reviews

承認やレビューを含む、プルリクエストのレビュー履歴を取得します。

パラメーター：

• project：Bitbucket プロジェクトキー（設定されている場合、デフォルトで BITBUCKET_DEFAULT_PROJECT が使用されます）
• repository：リポジトリのスラッグ（設定されている場合、デフォルトで BITBUCKET_DEFAULT_REPOSITORY が使用されます）
• prId（必須）：プルリクエスト ID

push_files

複数のファイルを単一のコミットでリポジトリのブランチにプッシュします。

パラメーター：

• project：Bitbucket プロジェクトキー（設定されている場合、デフォルトで BITBUCKET_DEFAULT_PROJECT が使用されます）
• repository：リポジトリのスラッグ（設定されている場合、デフォルトで BITBUCKET_DEFAULT_REPOSITORY が使用されます）
• branch（必須）：プッシュ先のブランチ名
• message（必須）：コミットメッセージ
• files（必須）：ファイルオブジェクトの配列。各オブジェクトには次が含まれます：
  • path（必須）：リポジトリのルートからの相対ファイルパス
  • content（必須）：ファイルにプッシュする内容

依存関係

• @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",
        // Authentication (choose one):
        // Option 1: Personal Access Token
        "BITBUCKET_TOKEN": "your-access-token",
        // Option 2: Username/Password
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-password",
        // Optional: Default project
        "BITBUCKET_DEFAULT_PROJECT": "your-default-project",
        // Optional: Default repository
        "BITBUCKET_DEFAULT_REPOSITORY": "your-default-repository"
      }
    }
  }
}

環境変数

• BITBUCKET_URL（必須）：Bitbucket Server インスタンスのベース URL
• 認証（以下のいずれかが必須）：
  • BITBUCKET_TOKEN：個人用アクセストークン
  • BITBUCKET_USERNAME と BITBUCKET_PASSWORD：Basic 認証の認証情報
• BITBUCKET_DEFAULT_PROJECT：ツール呼び出しで指定されていない場合に使用するデフォルトのプロジェクトキー
• BITBUCKET_DEFAULT_REPOSITORY：ツール呼び出しで指定されていない場合に使用するデフォルトのリポジトリスラッグ

ロギング

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