MCP Server Atlassian Bitbucket

🚀 Atlassian Bitbucket MCP サーバー

Atlassian Bitbucket MCP サーバーは、Bitbucket コードリポジトリとやり取りするためのツールです。以下の機能をサポートしています。

• 検索：指定されたワークスペース内でファイル、プルリクエスト、コミットを検索します。
• プルリクエスト管理：プルリクエストの作成、表示、コメントを行います。
• 問題追跡：問題の一覧表示とコメントの追加を行います。

🚀 クイックスタート

Atlassian Bitbucket MCP サーバーを使用することで、Bitbucket コードリポジトリとのやり取りを効率的に行うことができます。以下のセクションでは、インストール方法や使用方法を詳しく説明します。

📦 インストール

前提条件

1. Node.js のバージョン要件：Node.js 14.x 以上。LTS バージョンの使用を推奨します。
2. npm をインストールする必要があります。

キー認証の使用

1. Bitbucket で OAuth メッセージキーを生成します。
   • Bitbucket 管理コンソールにログインします。
   • OAuth ツール > コンシューマーの生成に移動します。
   • Consumer Key（例：mcp-server）を入力します。
   • キーペアを生成し、ダウンロードします。
2. MCP サーバーを構成します。

   BITBUCKET_OAUTH_KEY=your_consumer_key \
   BITBUCKET_OAUTH_SECRET=your_secret_key \
   npm install -g @aashari/mcp-server-atlassian-bitbucket
   

3. パスワード認証を使用する（オプション）：

   npm install -g @aashari/mcp-server-atlassian-bitbucket
   

構成方法

ファイルベースの構成

config.json ファイルを作成し、以下の内容を記述します。

{
  "bitbucket": {
    "base-url": "https://api.bitbucket.org",
    "workspace": "your_workspace"
  },
  "auth": {
    "type": "oauth2",
    "consumer-key": "your_consumer_key",
    "secret-key": "your_secret_key"
  }
}

環境変数の構成

以下の環境変数を設定します。

• BITBUCKET_BASE_URL：Bitbucket API のアドレス。デフォルトは https://api.bitbucket.org です。
• BITBUCKET_WORKSPACE：対象のワークスペース。
• BITBUCKET_AUTH_TYPE：認証タイプ。oauth2 と password をサポートしています。
  • oauth2 の場合：
    • BITBUCKET_OAUTH_KEY：コンシューマーキー。
    • BITBUCKET_OAUTH_SECRET：シークレットキー。
  • password の場合：
    • BITBUCKET_USERNAME：Bitbucket のユーザー名。
    • BITBUCKET_PASSWORD：Bitbucket のパスワード。

インストールと実行

npm install -g @aashari/mcp-server-atlassian-bitbucket
mcp-atlassian-bitbucket --help

💻 使用例

基本的な使用法

検索機能

ファイルの検索

{
  "workspace": "your_workspace",
  "query": "search_string",
  "scope": "files"
}

プルリクエストの検索

{
  "workspace": "your_workspace",
  "repo_slug": "repository_name",
  "query": "pr_keyword",
  "scope": "pullrequests"
}

コミット履歴の検索

{
  "workspace": "your_workspace",
  "repo_slug": "repository_name",
  // 元のREADMEにここでコードが途切れていたので、そのままにしています
}