Bitbucket MCP Server

Bitbucket MCP サーバー

リポジトリ、プルリクエスト、課題を管理するための Bitbucket API との連携を提供する Model Context Protocol（MCP）サーバーです。

機能

• リポジトリの一覧表示と詳細の取得
• プルリクエストの管理（一覧表示、詳細の取得、作成）
• 課題の閲覧
• TypeScript の完全サポート
• エラー処理と検証

セットアップ

1. 依存関係をインストールします：

npm install

2. 認証を設定します：

cp .env.example .env
# Edit .env with your Bitbucket credentials

3. プロジェクトをビルドします：

npm run build

4. サーバーを実行します：

npm start

認証

Bitbucket アプリパスワードを作成します：

1. https://bitbucket.org/account/settings/app-passwords/ にアクセスします
2. 必要な権限を指定して新しいアプリパスワードを作成します：
   • リポジトリ：読み取り、書き込み
   • プルリクエスト：読み取り、書き込み
   • 課題：読み取り、書き込み

利用可能なツール

リポジトリ管理

• bitbucket_list_repositories - ワークスペース内のリポジトリを一覧表示します
• bitbucket_get_repository - リポジトリの詳細を取得します

プルリクエスト管理

• bitbucket_list_pull_requests - プルリクエストを一覧表示します
• bitbucket_get_pull_request - プルリクエストの詳細を取得します
• bitbucket_create_pull_request - 新しいプルリクエストを作成します

課題管理

• bitbucket_list_issues - リポジトリの課題を一覧表示します

MCP の設定

Claude Desktop

次の内容を Claude Desktop の設定ファイルに追加します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/path/to/bitbucket-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Cursor IDE

次の内容を Cursor の設定に追加します：

1. Cursor の設定を開きます（Cmd/Ctrl + ,）
2. 「MCP」を検索するか、Extensions > MCP に移動します
3. 新しいサーバー設定を追加します：

{
  "name": "bitbucket",
  "command": "node",
  "args": ["/path/to/bitbucket-mcp-server/build/index.js"],
  "env": {
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_APP_PASSWORD": "your-app-password"
  }
}

開発

# Development mode with auto-reload
npm run dev

# Type checking
npm run typecheck

# Linting
npm run lint