atlassian-dc-mcp-bitbucket

atlassian-dc-mcp-bitbucket

b1ffMIT
74 звёзд31 форков
MCP-сервер для интеграции AI-ассистентов с Atlassian Bitbucket Data Center. Разработчикам не нужно переключаться между окнами: можно прямо в чате просматривать код, проверять пул-реквесты и искать по репозиториям. Сервер безопасно хранит учётные данные в системном хранилище и автоматически проверяет подключение при настройке. В отличие от облачного Bitbucket Cloud, эта версия создана специально для саморазмещённых экземпляров Data Center. Проект разрабатывается сообществом и не имеет прямой аффилиации с Atlassian.
DevelopmentJira
Открыть на GitHub

Установка

npx -y @atlassian-dc-mcp/bitbucket

Характеристики

Общее

  • СтатусСообщество
  • Разработчикb1ff
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Настраивает подключение в интерактивном режиме: команда setup последовательно запрашивает хост, базовый путь API, размер страницы и токен.
  • Работает в неинтерактивном режиме: передайте параметры через флаги --host, --api-base-path, --token и --default-page-size для автоматизации в CI/CD.
  • Проверяет учётные данные перед сохранением: выполняет пробный авторизованный запрос к API Bitbucket и сообщает об ошибках.
  • Хранит токен в защищённом хранилище операционной системы (macOS Keychain, Windows Credential Manager).
  • Автоматически переиспользует существующий токен при повторной настройке, если флаг --token не указан.
  • Открывает AI-ассистентам доступ к репозиториям Bitbucket для просмотра кода, пул-реквестов и лога коммитов.
  • Поддерживает поиск по кодовой базе: ассистент находит нужные файлы и фрагменты кода по запросу.
  • Написан на TypeScript, использует транспорт stdio.
  • Входит в экосистему @atlassian-dc-mcp вместе с серверами для Jira и Confluence.

Как подключить

  1. Запустите настройку сервера. В терминале выполните:
    npx -y @atlassian-dc-mcp/bitbucket setup
    Утилита запросит хост (например, bitbucket.yourcompany.com), базовый путь API, размер страницы по умолчанию и API-токен. Каждый шаг выводит подсказку, а перед сохранением выполняется проверка подключения.
  2. Для неинтерактивной установки (CI/CD) передайте параметры флагами:
    npx @atlassian-dc-mcp/bitbucket setup --non-interactive --host bitbucket.example.com --token JWT_TOKEN
    В этом режиме сервер завершится с ошибкой, если валидация не пройдена.
  3. Добавьте сервер в конфигурацию MCP-клиента. Пример для Claude Desktop:
    { "mcpServers": { "bitbucket": { "command": "npx", "args": [ "-y", "@atlassian-dc-mcp/bitbucket" ] } } }
  4. Перезапустите клиент и начинайте работу.

Примеры запросов

  • «Покажи список всех репозиториев в проекте DEV.»
  • «Какие пул-реквесты сейчас открыты и ожидают моего ревью?»
  • «Покажи содержимое файла config.ts из ветки main в репозитории backend.»
  • «Найди в коде все упоминания устаревшей функции deprecatedMethod.»
  • «Покажи последние 10 коммитов в репозитории frontend по ветке develop.»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Разработчик: b1ff
  • Звёзды на GitHub: 74
  • Совместимость: Claude Desktop, VS Code + Continue, Cursor и любые MCP-клиенты с поддержкой stdio
  • Категория: Разработка, DevOps

Поделиться