Bitbucket MCP

Сервер протокола контекста модели (MCP), который интегрирует Cursor IDE с Bitbucket Cloud, позволяя вам получать информацию о репозиториях и данные о коммитах напрямую из вашего рабочего пространства Bitbucket.

Функции

• Список репозиториев: Получение всех репозиториев из вашего рабочего пространства Bitbucket

• Детали репозитория: Получение подробной информации о конкретных репозиториях

• Информация о коммитах: Получение истории коммитов и деталей последнего коммита

• Количество коммитов: Получение общего количества коммитов для каждого репозитория

• Данные о последнем коммите: Получение даты, автора и сообщения последнего коммита для каждого репозитория

• Рабочие пространства: Список всех доступных рабочих пространств.

• Pull-запросы: Создание, просмотр, список и обновление pull-запросов, включая чтение и добавление комментариев к PR.

• Проекты: Просмотр деталей проекта и список рецензентов по умолчанию.

• Ограничения веток: Управление ограничениями веток для проектов и репозиториев.

• Коммиты: Получение отдельных коммитов и списков коммитов.

Related MCP server: JIRA MCP Server

Предварительные требования

• Node.js 18 или выше

• npm или yarn

• Учетная запись Bitbucket Cloud

• Пароль приложения Bitbucket (для аутентификации)

Настройка

1. Установка зависимостей

npm install

2. Сборка проекта

npm run build

3. Создание токена API Atlassian*

• если у вас уже есть токен для Jira или Confluence, вы можете использовать его повторно *

1. Перейдите в настройки вашей учетной записи Bitbucket

2. Перейдите в раздел "App passwords" (Пароли приложений) в меню "Access management" (Управление доступом)

3. Вместо нажатия "Create app password" (устарело), перейдите в "Go to API tokens" (Перейти к токенам API)

4. Создайте токен API

5. Дайте ему описательное имя (например, "Cursor MCP Integration")

6. Выберите дату истечения срока действия

7. Скопируйте созданный токен

4. Настройка переменных окружения

Создайте файл .env в корне проекта:

BITBUCKET_USERNAME=your_bitbucket_email_address
BITBUCKET_APP_PASSWORD=your_api_token
BITBUCKET_WORKSPACE=your_workspace_name

Примечание: Имя рабочего пространства обычно совпадает с вашим именем пользователя или названием организации. Вы можете найти его в своих URL-адресах Bitbucket (например, https://bitbucket.org/workspace_name/).

5. Добавление в конфигурацию MCP Cursor

Добавьте следующую конфигурацию в настройки MCP Cursor:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["@korfu/bitbucket-mcp"],
      "env": {
        "BITBUCKET_USERNAME": "your_bitbucket_email_address",
        "BITBUCKET_APP_PASSWORD": "your_api_token",
        "BITBUCKET_WORKSPACE": "your_workspace_name"
      }
    }
  }
}

6. Перезапуск Cursor

После добавления конфигурации перезапустите Cursor IDE, чтобы загрузить сервер MCP.

Использование

После настройки вы можете использовать следующие инструменты в Cursor:

Рабочие пространства

• bitbucket_list_workspaces

Репозитории

• bitbucket_list_repositories

• bitbucket_get_repository_details

Коммиты

• bitbucket_list_commits

• bitbucket_get_commit

Pull-запросы

• bitbucket_list_pull_requests

• bitbucket_get_pull_request

• bitbucket_create_pull_request

• bitbucket_update_pull_request

• bitbucket_list_pull_request_comments

• bitbucket_get_pull_request_comment

• bitbucket_add_pull_request_comment

Проекты

• bitbucket_get_project

• bitbucket_list_default_reviewers

Ограничения веток

• bitbucket_list_branch_restrictions

• bitbucket_get_branch_restriction

• bitbucket_update_repository_branching_model_settings

• bitbucket_update_project_branching_model_settings

Доступные инструменты

Рабочие пространства

• list_workspaces: Выводит список всех рабочих пространств, доступных текущему пользователю.

Репозитории

• list_repositories: Выводит список всех репозиториев в настроенном рабочем пространстве Bitbucket.

• get_repository_details: Получает подробную информацию о конкретном репозитории, включая информацию о последнем коммите.

Коммиты

• list_commits: Получает информацию о коммитах для конкретного репозитория.

• get_commit: Получает один коммит по его хешу.

Pull-запросы

• list_pull_requests: Выводит список всех pull-запросов в репозитории.

• get_pull_request: Получает один pull-запрос по его ID.

• create_pull_request: Создает новый pull-запрос. //Бета-версия - не протестировано

• update_pull_request: Обновляет существующий pull-запрос. //Бета-версия - не протестировано

• list_pull_request_comments: Выводит список всех комментариев к pull-запросу (глобальные, встроенные и ответы) с поддержкой пагинации.

• get_pull_request_comment: Получает один комментарий к pull-запросу по его ID, включая контекст встроенного файла/строки.

• add_pull_request_comment: Добавляет комментарий к pull-запросу. Поддерживает общие комментарии, встроенные комментарии к конкретным файлам/строкам и ответы в ветках.

Проекты

• get_project: Получает один проект по его ключу.

• list_default_reviewers: Выводит список рецензентов по умолчанию для проекта.

Ограничения веток

• list_branch_restrictions: Выводит список всех ограничений веток для репозитория.

• get_branch_restriction: Получает одно ограничение ветки по его ID.

• update_repository_branching_model_settings: Обновляет конфигурацию модели ветвления для репозитория. //Бета-версия - не протестировано

• update_project_branching_model_settings: Обновляет конфигурацию модели ветвления для проекта. //Бета-версия - не протестировано

Разработка

Запуск в режиме разработки

npm run dev

Сборка

npm run build

Структура проекта

BitbucketMCP/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── .gitignore           # Git ignore rules
└── README.md            # This file

Устранение неполадок

Проблемы с аутентификацией

• Убедитесь, что ваше имя пользователя Bitbucket и пароль приложения верны

• Убедитесь, что пароль приложения имеет правильные разрешения (Repositories: Read)

• Проверьте правильность имени рабочего пространства

Проблемы с подключением

• Проверьте интернет-соединение

• Проверьте, доступен ли API Bitbucket из вашей сети

• Убедитесь, что сервер MCP запущен (проверьте логи MCP в Cursor)

Репозиторий не найден

• Убедитесь, что имя репозитория верно (используйте слаг репозитория, а не отображаемое имя)

• Убедитесь, что у вас есть доступ к репозиторию

• Проверьте, существует ли репозиторий в указанном рабочем пространстве

Сервер MCP не загружается

• Убедитесь, что путь к dist/index.js верен в вашей конфигурации Cursor

• Убедитесь, что Node.js установлен и доступен из командной строки

• Проверьте логи сервера MCP в Cursor на наличие сообщений об ошибках

Примечания по безопасности

• Храните пароль приложения Bitbucket в безопасности и никогда не фиксируйте его в системе контроля версий

• Используйте переменные окружения или безопасное управление конфигурацией для учетных данных

• Пароль приложения должен иметь только минимально необходимые разрешения

• Регулярно меняйте пароль приложения

Вклад в проект

1. Сделайте форк репозитория

2. Создайте ветку для функции

3. Внесите изменения

4. Добавьте тесты, если применимо

5. Отправьте pull-запрос

Лицензия

Лицензия MIT - подробности см. в файле LICENSE