Bitbucket Server MCP

Bitbucket Server MCP

Bitbucket Server 向けのプロフェッショナルな Model Context Protocol（MCP）サーバーです。プルリクエスト管理、コードレビュー、リポジトリ操作をシームレスに自動化し、統合できます。

---

目次

• 概要
• 機能
• インストール
• クイックスタート
• MCP サーバーの設定
• 環境変数
• 開発
• テスト
• コントリビューション
• ライセンス

---

概要

Bitbucket Server MCP は、Model Context Protocol を介して Bitbucket Server のリポジトリとプルリクエストを自動化・管理するための堅牢なインターフェースを提供します。エンタープライズ環境向けに設計されており、高度なワークフロー、大規模な差分、MCP クライアントとのシームレスな統合をサポートします。

---

機能

• リポジトリ、ブランチ、プルリクエストの一覧表示
• プルリクエストの作成、更新、マージ（マージコミット、スカッシュ、ファストフォワード）
• プルリクエストの却下と削除
• コメントとインラインコードの提案の追加
• プルリクエストの差分とレビュー状況の取得
• 大規模なプルリクエストの差分を効率的に処理
• MCP プロトコル向けの拡張可能なツールハンドラーの配線
• クロスプラットフォーム対応（Windows、Mac、Linux）

---

インストール

npx を使用する（推奨）

クローンせずに直接実行します。

npx -y bitbucket-server-mcp

ローカルインストール

プロジェクトをクローンしてビルドします。

git clone https://github.com/your-org/bitbucket-server-mcp.git
cd bitbucket-server-mcp
npm install
npm run build

---

クイックスタート

1. .env.example を .env にコピーし、Bitbucket Server の認証情報を設定します。

2. MCP サーバーを起動します。

   npm start
   # or
   node build/index.js
   

---

🚀 MCP サーバーの設定

MCP の設定（例：cline_mcp_settings.json）に次の内容を追加します。

{
  "servers": [
    {
      "name": "bitbucket-server-mcp",
      "command": "npx",
      "args": ["-y", "bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server",
        "BITBUCKET_TOKEN": "your-access-token",
        "BITBUCKET_DEFAULT_PROJECT": "your-default-project",
        "BITBUCKET_DEFAULT_REVIEWERS": "user1,user2"
      }
    }
  ]
}

Node を直接使用する

npx を利用できない場合は、次のように設定します。

• Windows：

  "command": "node",
  "args": ["C:\\path\\to\\bitbucket-server-mcp\\build\\index.js"],
  

• Mac/Linux：

  "command": "node",
  "args": ["/path/to/bitbucket-server-mcp/build/index.js"],
  

---

環境変数

変数	説明	必須	例
BITBUCKET_URL	Bitbucket Server のベース URL	はい	https://bitbucket.example.com
BITBUCKET_TOKEN	個人用アクセストークン	はい	your-access-token
BITBUCKET_DEFAULT_PROJECT	デフォルトのプロジェクトキー	いいえ	PROJKEY
BITBUCKET_DEFAULT_REVIEWERS	カンマ区切りのレビュアーのユーザー名	いいえ	user1,user2
BITBUCKET_USERNAME	ユーザー名（トークンを使用しない場合）	いいえ	your-username
BITBUCKET_PASSWORD	パスワード（トークンを使用しない場合）	いいえ	your-password

詳細は .env.example を参照してください。

---

開発

• コードをリントします：

  npm run lint
  

• ウォッチモードで実行します：

  npm run dev
  

---

テスト

テストスイートを実行します。

npm test

---

コントリビューション

コントリビューションを歓迎します！新機能、バグ修正、改善については、Issue を作成するか、プルリクエストを送信してください。

---

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

---