Bitbucket Server MCP

Сервер MCP (Model Context Protocol) для управления запросами на слияние (Pull Request) в Bitbucket Server. Этот сервер предоставляет инструменты и ресурсы для взаимодействия с API Bitbucket Server через протокол MCP.

✨ Новые возможности

• 🔧 Пользовательские HTTP-заголовки: Добавляйте собственные заголовки ко всем запросам через переменную окружения BITBUCKET_CUSTOM_HEADERS (полезно для токенов Zero Trust или прокси-серверов)

• 📋 Поиск PR: Просматривайте и фильтруйте pull request'ы по состоянию, автору или направлению с помощью list_pull_requests (исправлено #14)

• 🌿 Управление ветками: Получайте список веток с автоматическим определением ветки по умолчанию с помощью list_branches, удаляйте слитые ветки с помощью delete_branch

• 📝 История коммитов: Просматривайте историю коммитов с фильтрацией по ветке и автору с помощью list_commits

• ✅ Одобрение PR: Одобряйте и отменяйте одобрение pull request'ов с помощью approve_pull_request и unapprove_pull_request

• 🔍 Расширенный поиск: Ищите код и файлы в репозиториях с фильтрацией по проекту/репозиторию с помощью инструмента search

• 📄 Операции с файлами: Читайте содержимое файлов и просматривайте директории репозитория с помощью get_file_content и browse_repository

• 💬 Управление комментариями: Извлекайте и фильтруйте комментарии к PR с помощью инструмента get_comments

• 🔍 Поиск проектов: Получайте список всех доступных проектов Bitbucket с помощью list_projects

• 📁 Просмотр репозиториев: Исследуйте репозитории в разных проектах с помощью list_repositories

• 🔧 Гибкая поддержка проектов: Сделайте проект по умолчанию необязательным — указывайте его для каждой команды или используйте BITBUCKET_DEFAULT_PROJECT

• 📖 Улучшенная документация: Обновленный README с примерами использования и лучшими рекомендациями по настройке

Related MCP server: GitHub PR Comments MCP Server

Требования

• Node.js >= 16

Установка

Установка через Smithery

Чтобы автоматически установить Bitbucket Server для Claude Desktop через Smithery:

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

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

npm install

Сборка

npm run build

Возможности

Сервер предоставляет следующие инструменты для комплексной интеграции с Bitbucket Server:

list_projects

Обнаружение и исследование проектов Bitbucket: Выводит список всех доступных проектов с их деталями. Необходим для поиска проектов и определения правильных ключей проектов для использования в других операциях.

Варианты использования:

• Поиск доступных проектов, когда вы не знаете точный ключ проекта

• Изучение структуры проекта и прав доступа

• Обнаружение новых проектов, к которым у вас есть доступ

Параметры:

• limit: Количество возвращаемых проектов (по умолчанию: 25, макс: 1000)

• start: Начальный индекс для пагинации (по умолчанию: 0)

list_repositories

Просмотр и поиск репозиториев: Исследуйте репозитории в конкретных проектах или во всех доступных проектах. Возвращает полную информацию о репозитории, включая URL-адреса для клонирования и метаданные.

Варианты использования:

• Поиск слагов (slugs) репозиториев для других операций

• Изучение структуры кодовой базы в разных проектах

• Обнаружение репозиториев, к которым у вас есть доступ

• Просмотр репозиториев конкретного проекта

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• limit: Количество возвращаемых репозиториев (по умолчанию: 25, макс: 1000)

• start: Начальный индекс для пагинации (по умолчанию: 0)

create_pull_request

Предложение изменений кода для рецензирования: Создает новый pull request для отправки изменений кода, запроса рецензий или слияния веток с функциями. Автоматически обрабатывает ссылки на ветки и назначение рецензентов.

Варианты использования:

• Отправка разработки функций на рецензию

• Предложение исправлений ошибок

• Запрос интеграции кода из веток функций

• Совместная работа над изменениями кода

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• title (обязательно): Четкий, описательный заголовок PR

• description: Подробное описание с контекстом (поддерживает Markdown)

• sourceBranch (обязательно): Исходная ветка, содержащая изменения

• targetBranch (обязательно): Целевая ветка для слияния

• reviewers: Массив имен пользователей рецензентов

• sourceProject: Ключ проекта исходного репозитория (для кросс-репозиторных PR из форков)

• sourceRepository: Слаг исходного репозитория (для кросс-репозиторных PR из форков)

• includeDefaultReviewers: Автоматически находить и включать рецензентов по умолчанию, настроенных для целевой ветки (по умолчанию: true)

update_pull_request

Безопасное обновление pull request'а: Изменяйте заголовок, описание или рецензентов существующего pull request'а без потери метаданных. Использует шаблон «чтение-модификация-запись» для сохранения всех полей, которые не были явно изменены.

Варианты использования:

• Исправление заголовка или описания PR после создания

• Добавление или замена рецензентов без потери существующих

• Обновление метаданных PR без влияния на статус одобрения

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а для обновления

• title: Новый заголовок (если пропущено, сохраняется текущий)

• description: Новое описание (если пропущено, сохраняется текущее)

• reviewers: Новый список рецензентов в виде массива имен пользователей (если пропущено, сохраняются текущие рецензенты)

get_pull_request

Полная информация о PR: Получает подробную информацию о pull request'е, включая статус, рецензентов, коммиты и все метаданные. Необходим для понимания состояния PR перед выполнением действий.

Варианты использования:

• Проверка статуса одобрения PR

• Просмотр деталей и прогресса PR

• Понимание изменений перед слиянием

• Мониторинг статуса PR

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а

merge_pull_request

Интеграция одобренных изменений: Сливает одобренный pull request в целевую ветку. Поддерживает различные стратегии слияния в зависимости от ваших предпочтений в рабочем процессе.

Варианты использования:

• Завершение процесса рецензирования кода

• Интеграция одобренных функций

• Применение исправлений ошибок в основные ветки

• Выпуск изменений кода

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а

• message: Пользовательское сообщение коммита слияния

• strategy: Стратегия слияния:

  • merge-commit (по умолчанию): Создает коммит слияния, сохраняя историю

  • squash: Объединяет все коммиты в один

  • fast-forward: Перемещает указатель ветки без создания коммита слияния

decline_pull_request

Отклонение неподходящих изменений: Отклоняет pull request, который не должен быть слит, предоставляя обратную связь автору.

Варианты использования:

• Отклонение изменений, не соответствующих стандартам

• Закрытие PR, конфликтующих с направлением проекта

• Запрос значительной доработки

• Предотвращение нежелательной интеграции кода

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а

• message: Причина отклонения (полезно для обратной связи автору)

add_comment

Участие в рецензировании кода: Добавляет комментарии к pull request'ам для обратной связи, обсуждений и совместной работы. Поддерживает вложенные обсуждения.

Варианты использования:

• Предоставление обратной связи по рецензии кода

• Задание вопросов о конкретных изменениях

• Предложение улучшений

• Участие в технических дискуссиях

• Документирование решений по рецензированию

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а

• text (обязательно): Содержимое комментария (поддерживает Markdown)

• parentId: ID родительского комментария для вложенных ответов

• state: Состояние комментария: OPEN (по умолчанию, публикуется немедленно) или PENDING (черновик, виден только вам до публикации рецензии)

get_diff

Анализ изменений кода: Получает различия в коде, показывая точно, что было добавлено, удалено или изменено в pull request'е. Поддерживает усечение для каждого файла, чтобы эффективно управлять большими diff'ами.

Варианты использования:

• Рецензирование конкретных изменений кода

• Понимание объема модификаций

• Анализ влияния перед слиянием

• Изучение деталей реализации

• Оценка качества кода

• Обработка больших файлов без перегрузки вывода

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а

• contextLines: Строки контекста вокруг изменений (по умолчанию: 10)

• maxLinesPerFile: Максимальное количество строк для отображения на файл (необязательно, если не указано, используется переменная окружения BITBUCKET_DIFF_MAX_LINES_PER_FILE, установите 0 для отсутствия ограничений)

Обработка больших файлов: Когда файл превышает лимит maxLinesPerFile, отображается:

• Заголовки файлов и метаданные (всегда сохраняются)

• Первые 60% разрешенных строк с начала

• Сообщение об усечении со статистикой файла

• Последние 40% разрешенных строк с конца

• Четкое указание, как увидеть полный diff

get_reviews

Отслеживание прогресса рецензирования: Получает историю рецензирования, статус одобрения и обратную связь рецензентов, чтобы понять состояние рецензии.

Варианты использования:

• Проверка готовности PR к слиянию

• Просмотр того, кто рецензировал изменения

• Понимание обратной связи по рецензии

• Мониторинг требований к одобрению

• Отслеживание прогресса рецензирования

get_activities

Получение активности pull request'а: Получает полную временную шкалу активности для pull request'а, включая комментарии, рецензии, коммиты и другие события.

Варианты использования:

• Чтение обсуждений комментариев и обратной связи

• Просмотр полной временной шкалы PR

• Отслеживание коммитов, добавленных/удаленных из PR

• Просмотр истории одобрений и рецензий

• Понимание полного жизненного цикла PR

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а

get_comments

Извлечение только комментариев PR: Фильтрует активность pull request'а, возвращая только комментарии, что упрощает фокусировку на содержании обсуждения без рецензий или других действий.

Варианты использования:

• Чтение веток обсуждения PR

• Извлечение обратной связи и вопросов

• Фокусировка на содержании комментариев без лишнего шума

• Анализ потока разговора

Параметры:

• project: Ключ проекта Bitbucket (необязательно, если не указан, используется BITBUCKET_DEFAULT_PROJECT)

• repository (обязательно): Слаг репозитория

• prId (обязательно): ID pull request'а

search

Расширенный поиск по коду и файлам: Поиск по репозиториям с использованием API поиска Bitbucket с поддержкой фильтрации по проекту/репозиторию и оптимизацией запросов. Ищет как содержимое файлов, так и имена файлов. Примечание: Поиск работает только в ветке по умолчанию репозиториев.

Варианты использования:

• Поиск конкретных шаблонов кода в проектах

• Поиск файлов по имени или содержимому

• Поиск в конкретных проектах или репозиториях

• Фильтрация по расширениям файлов

Параметры:

• query (обязательно): Строка поискового запроса

• project: Ключ проекта Bitbucket для ограничения области поиска

• repository: Слаг репозитория для поиска в конкретном репозитории

• type: Оптимизация запроса — "file" (за