Skip to main content
Glama

Bitbucket MCP

by MatanYemini

Bitbucket MCP

Сервер Model Context Protocol (MCP) для интеграции с Bitbucket Cloud и API сервера. Этот сервер MCP позволяет помощникам ИИ, таким как Cursor, взаимодействовать с вашими репозиториями Bitbucket, запросами на извлечение и другими ресурсами.

Безопасность прежде всего

Это безопасный и ответственный пакет — операции DELETE не используются, поэтому нет риска потери данных. Каждый запрос на извлечение анализируется с помощью CodeQL, чтобы гарантировать безопасность кода.

Обзор

Ознакомьтесь с официальным пакетом npm Этот сервер реализует стандарт Model Context Protocol для предоставления помощникам ИИ доступа к данным и операциям Bitbucket. Он включает в себя инструменты для:

  • Список и извлечение репозиториев
  • Получение данных репозитория
  • Получение запросов на извлечение
  • И многое другое...

Установка

Использование NPX (рекомендуется)

Самый простой способ использовать этот сервер MCP — через NPX, что позволяет запускать его без глобальной установки:

# Run with environment variables BITBUCKET_URL="https://bitbucket.org/your-workspace" \ BITBUCKET_USERNAME="your-username" \ BITBUCKET_PASSWORD="your-app-password" \ npx -y bitbucket-mcp@latest

Ручная установка

Кроме того, вы можете установить его глобально или как часть своего проекта:

# Install globally npm install -g bitbucket-mcp # Or install in your project npm install bitbucket-mcp

Затем запустите его с помощью:

# If installed globally BITBUCKET_URL="https://bitbucket.org/your-workspace" \ BITBUCKET_USERNAME="your-username" \ BITBUCKET_PASSWORD="your-app-password" \ bitbucket-mcp # If installed in your project BITBUCKET_URL="https://bitbucket.org/your-workspace" \ BITBUCKET_USERNAME="your-username" \ BITBUCKET_PASSWORD="your-app-password" \ npx bitbucket-mcp

Конфигурация

Переменные среды

Настройте сервер, используя следующие переменные среды:

ПеременнаяОписаниеНеобходимый
BITBUCKET_URLБазовый URL Bitbucket (например, « https://bitbucket.org/your-workspace »)Да
BITBUCKET_USERNAMEВаше имя пользователя BitbucketДа*
BITBUCKET_PASSWORDВаш пароль к приложению BitbucketДа*
BITBUCKET_TOKENВаш токен доступа Bitbucket (альтернатива имени пользователя/паролю)Нет
BITBUCKET_WORKSPACEРабочее пространство по умолчанию, используемое, если не указано иноеНет

* Необходимо указать либо BITBUCKET_TOKEN , либо BITBUCKET_USERNAME и BITBUCKET_PASSWORD .

Создание пароля приложения Bitbucket

  1. Войдите в свою учетную запись Bitbucket
  2. Перейдите в раздел «Персональные настройки» > «Пароли приложений».
  3. Создайте новый пароль приложения со следующими разрешениями:
    • Репозитории: Читать
    • Запросы на извлечение: чтение, запись
  4. Скопируйте сгенерированный пароль и используйте его как переменную среды BITBUCKET_PASSWORD

Интеграция с курсором

Чтобы интегрировать этот MCP-сервер с Cursor:

  1. Открытый курсор
  2. Перейдите в Настройки > Расширения.
  3. Нажмите «Протокол контекста модели».
  4. Добавьте новую конфигурацию MCP:
"bitbucket": { "command": "npx", "env": { "BITBUCKET_URL": "https://bitbucket.org/your-workspace", "BITBUCKET_USERNAME": "your-username", "BITBUCKET_PASSWORD": "your-app-password" }, "args": ["-y", "bitbucket-mcp@latest"] }
  1. Сохранить конфигурацию
  2. Используйте команду «/bitbucket» в Cursor для доступа к репозиториям Bitbucket и запросам на извлечение.

Использование локальной сборки с курсором

Если вы ведете локальную разработку и хотите протестировать свои изменения:

"bitbucket-local": { "command": "node", "env": { "BITBUCKET_URL": "https://bitbucket.org/your-workspace", "BITBUCKET_USERNAME": "your-username", "BITBUCKET_PASSWORD": "your-app-password" }, "args": ["/path/to/your/local/bitbucket-mcp/dist/index.js"] }

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

Этот сервер MCP предоставляет инструменты для взаимодействия с репозиториями Bitbucket и pull-запросами. Ниже приведен полный список доступных операций:

Операции репозитория

listRepositories

Перечисляет репозитории в рабочей области.

Параметры:

  • workspace (необязательно): имя рабочего пространства Bitbucket
  • limit (необязательно): максимальное количество возвращаемых репозиториев
getRepository

Получает сведения о конкретном репозитории.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория

Операции по запросу на извлечение

getPullRequests

Получает запросы на извлечение изменений для репозитория.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • state (необязательно): состояние запроса на извлечение ( OPEN , MERGED , DECLINED , SUPERSEDED )
  • limit (необязательно): максимальное количество возвращаемых запросов на извлечение
createPullRequest

Создает новый запрос на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • title : заголовок запроса на извлечение
  • description : Описание запроса на извлечение
  • sourceBranch : Имя исходной ветки
  • targetBranch : Имя целевой ветки
  • reviewers (необязательно): список имен пользователей рецензентов
getPullRequest

Получает сведения о конкретном запросе на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
updatePullRequest

Обновляет запрос на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • Различные необязательные параметры обновления (название, описание и т. д.)
getPullRequestActivity

Получает журнал активности для запроса на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
approvePullRequest

Одобряет запрос на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
unapprovePullRequest

Удаляет одобрение из запроса на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
declinePullRequest

Отклоняет запрос на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • message (необязательно): Причина отклонения
mergePullRequest

Объединяет запрос на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • message (необязательно): сообщение о слиянии
  • strategy (необязательно): стратегия слияния ( merge-commit , squash , fast-forward )
requestChanges

Запрашивает изменения по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
removeChangeRequest

Удаляет запрос на изменение из запроса на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение

Операции по комментированию запросов на извлечение

getPullRequestComments

Список комментариев к запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
createPullRequestComment

Создает комментарий к запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • content : Содержание комментария
  • inline (необязательно): Встроенная информация о комментарии
getPullRequestComment

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

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • comment_id : идентификатор комментария
updatePullRequestComment

Обновляет комментарий к запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • comment_id : идентификатор комментария
  • content : Обновленное содержание комментария
deletePullRequestComment

Удаляет комментарий к запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • comment_id : идентификатор комментария
resolveComment

Закрывает ветку комментариев по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • comment_id : идентификатор комментария
reopenComment

Повторно открывает решенную ветку комментариев по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • comment_id : идентификатор комментария

Операции по изменению запроса на извлечение

getPullRequestDiff

Получает разницу для запроса на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
getPullRequestDiffStat

Получает статистику различий для запроса на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
getPullRequestPatch

Получает патч для запроса на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение

Операции по выполнению задач запроса на извлечение

getPullRequestTasks

Перечисляет задачи по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
createPullRequestTask

Создает задачу по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • content : Содержание задачи
  • comment (необязательно): идентификатор комментария для связи с задачей
  • pending (необязательно): находится ли задача в ожидании
getPullRequestTask

Получает конкретную задачу по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • task_id : идентификатор задачи
updatePullRequestTask

Обновляет задачу по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • task_id : идентификатор задачи
  • content (необязательно): обновленное содержимое задачи
  • state (необязательно): обновленное состояние задачи
deletePullRequestTask

Удаляет задачу по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
  • task_id : идентификатор задачи

Другие операции по запросу на извлечение

getPullRequestCommits

Список коммитов по запросу на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение
getPullRequestStatuses

Список статусов коммитов для запроса на извлечение.

Параметры:

  • workspace : Имя рабочего пространства Bitbucket
  • repo_slug : Слаг репозитория
  • pull_request_id : идентификатор запроса на извлечение

Разработка

Предпосылки

  • Node.js 18 или выше
  • нпм или пряжа

Настраивать

# Clone the repository git clone https://github.com/MatanYemini/bitbucket-mcp.git cd bitbucket-mcp # Install dependencies npm install # Build the project npm run build # Run in development mode npm run dev

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Ссылки

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер Model Context Protocol, который позволяет помощникам на основе ИИ взаимодействовать с репозиториями Bitbucket, запросами на извлечение и другими ресурсами через API-интерфейсы Bitbucket Cloud и Server.

  1. Безопасность прежде всего
    1. Обзор
      1. Установка
        1. Использование NPX (рекомендуется)
        2. Ручная установка
      2. Конфигурация
        1. Переменные среды
        2. Создание пароля приложения Bitbucket
      3. Интеграция с курсором
        1. Использование локальной сборки с курсором
      4. Доступные инструменты
        1. Операции репозитория
        2. Операции по запросу на извлечение
        3. Операции по комментированию запросов на извлечение
        4. Операции по изменению запроса на извлечение
        5. Операции по выполнению задач запроса на извлечение
        6. Другие операции по запросу на извлечение
      5. Разработка
        1. Предпосылки
        2. Настраивать
      6. Лицензия
        1. Ссылки

          Related MCP Servers

          • A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.
            Last updated -
            1
            JavaScript
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.
            Last updated -
            129
            Python
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables AI assistants to perform GitHub operations including repository management, file operations, issue tracking, and pull request creation.
            Last updated -
            1
            TypeScript
          • -
            security
            F
            license
            -
            quality
            A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
            Last updated -
            16
            TypeScript

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/MatanYemini/bitbucket-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server