Сервер Atlassian Bitbucket MCP

Этот проект предоставляет сервер Model Context Protocol (MCP), который действует как мост между помощниками ИИ (например, Claude от Anthropic, Cursor AI или другими MCP-совместимыми клиентами) и вашим экземпляром Atlassian Bitbucket. Он позволяет ИИ безопасно получать доступ и взаимодействовать с вашими репозиториями, запросами на извлечение и рабочими пространствами в режиме реального времени.

Обзор

Что такое МКП?

Model Context Protocol (MCP) — открытый стандарт, позволяющий системам искусственного интеллекта безопасно и контекстно подключаться к внешним инструментам и источникам данных.

Этот сервер реализует MCP специально для Bitbucket Cloud, связывая ваши данные Bitbucket с помощниками на основе искусственного интеллекта.

Зачем использовать этот сервер?

Философия минимального ввода, максимального вывода : все, что вам нужно, — это простые идентификаторы, такие как workspaceSlug и repoSlug . Каждый инструмент возвращает исчерпывающие сведения, не требуя дополнительных флагов.
Расширенная визуализация кода : получите подробную информацию о репозиториях и изменениях кода с помощью статистики файлов, представлений различий и интеллектуального контекста изменений кода.
Безопасная локальная аутентификация : учетные данные никогда не хранятся на сервере. Сервер работает локально, поэтому ваши токены никогда не покидают вашу машину, и вы можете запрашивать только те разрешения, которые вам нужны.
Интуитивно понятные ответы Markdown : все ответы используют хорошо структурированную разметку Markdown для удобства чтения с последовательным форматированием и навигационными ссылками.
Полная интеграция с Bitbucket : доступ к рабочим областям, репозиториям, запросам на извлечение, комментариям, поиску кода и многому другому через унифицированный интерфейс.

Начиная

Предпосылки

Node.js (>=18.x): Загрузить
Учетная запись облака Bitbucket

Шаг 1: Аутентификация

Выберите один из следующих методов аутентификации:

Вариант A: Пароль приложения Bitbucket (рекомендуется)

Сгенерируйте один из Bitbucket App Passwords . Минимальные разрешения:

Рабочие пространства: Читать
Репозитории: Читать
Запросы на извлечение: Читать

Вариант B: токен API Atlassian

Сгенерируйте его с помощью токенов API Atlassian .

Примечание: Хотя сервер может работать с использованием API-токена Atlassian (через стандартные переменные ATLASSIAN_* ) из-за общей системы учетных записей Atlassian, пароли приложений Bitbucket являются настоятельно рекомендуемым и официально поддерживаемым методом для этой интеграции. Пароли приложений позволяют использовать более детализированные, специфичные для Bitbucket области разрешений, повышая безопасность по сравнению с потенциально более широкими API-токенами.

Шаг 2: Настройте учетные данные

Метод A: Файл конфигурации MCP (рекомендуется)

Создайте или отредактируйте ~/.mcp/configs.json :

Использование пароля приложения Bitbucket:

{
	"bitbucket": {
		"environments": {
			"ATLASSIAN_BITBUCKET_USERNAME": "<your_username>",
			"ATLASSIAN_BITBUCKET_APP_PASSWORD": "<your_app_password>"
		}
	}
}

Использование токена API Atlassian:

{
	"bitbucket": {
		"environments": {
			"ATLASSIAN_SITE_NAME": "bitbucket",
			"ATLASSIAN_USER_EMAIL": "<your_email>",
			"ATLASSIAN_API_TOKEN": "<your_api_token>"
		}
	}
}

Примечание: Для обратной совместимости сервер также распознает конфигурации под полным именем пакета ( @aashari/mcp-server-atlassian-bitbucket ), именем пакета без области действия ( mcp-server-atlassian-bitbucket ) или в формате atlassian-bitbucket , если рекомендуемый ключ bitbucket не найден. Однако для новых конфигураций предпочтительнее использовать короткий ключ bitbucket .

Метод B: Переменные среды

Передайте учетные данные напрямую при запуске сервера:

ATLASSIAN_BITBUCKET_USERNAME="<your_username>" \
ATLASSIAN_BITBUCKET_APP_PASSWORD="<your_app_password>" \
npx -y @aashari/mcp-server-atlassian-bitbucket

Шаг 3: Подключите своего помощника на базе искусственного интеллекта

Настройте MCP-совместимый клиент для запуска этого сервера.

Конфигурация Клода / Курсора:

{
	"mcpServers": {
		"bitbucket": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
		}
	}
}

Эта конфигурация запускает сервер автоматически во время выполнения.

Инструменты

В этом разделе рассматриваются инструменты MCP, доступные при использовании этого сервера с помощником AI. Обратите внимание, что инструменты MCP используют snake_case для имен инструментов и camelCase для параметров.

`bb_ls_workspaces`

Список доступных рабочих пространств Bitbucket.

{}

или:

{ "query": "devteam" }

«Покажите мне все мои рабочие пространства Bitbucket».

`bb_get_workspace`

Получите полную информацию о конкретном рабочем пространстве.

{ "workspaceSlug": "acme-corp" }

«Расскажите мне подробнее о рабочем пространстве «acme-corp».

`bb_ls_repos`

Список репозиториев в рабочей области. Фильтрует по role , projectKey , query (имя/описание). Поддерживает сортировку и разбиение на страницы.

{ "workspaceSlug": "acme-corp", "projectKey": "PROJ" }

«Список репозиториев в 'acme-corp' для проекта PROJ».

`bb_get_repo`

Получите подробную информацию о конкретном репозитории, включая владельца, имя основной ветки, количество комментариев/задач и последние PR.

{ "workspaceSlug": "acme-corp", "repoSlug": "backend-api" }

«Покажите мне репозиторий 'backend-api' в 'acme-corp'».

`bb_search`

Поиск контента Bitbucket. Область действия с scope («репозитории», «запросы на извлечение», «коммиты», «код», «все»). Область действия кода поддерживает фильтры language и extension . Область действия «все» включает заголовок, указывающий, какая область действия вернула результаты.

Код (отфильтровано):

{
	"workspaceSlug": "acme-corp",
	"query": "Logger",
	"scope": "code",
	"language": "typescript"
}

«Найдите «Logger» в файлах TypeScript в рабочей области «acme-corp».

`bb_ls_prs`

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

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "state": "OPEN" }

«Показать открытые PR в 'frontend-app'».

`bb_get_pr`

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

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

«Получите PR #42 от 'frontend-app' со всеми изменениями кода».

`bb_ls_pr_comments`

Список комментариев по конкретному запросу на извлечение. Встроенные комментарии включают фрагменты кода.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

«Показать мне все комментарии к PR #42, включая контекст кода для встроенных комментариев».

`bb_create_pr_comment`

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

Общий:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"prId": "42",
	"content": "Looks good."
}

В соответствии:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"prId": "42",
	"content": "Consider refactoring.",
	"inline": { "path": "src/utils.js", "line": 42 }
}

«Добавьте комментарий к PR № 42 в строке 42».

`bb_create_pr`

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

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"title": "Add login screen",
	"sourceBranch": "feature/login"
}

«Создайте PR из «feature/login» в «main».

`bb_create_branch`

Создайте новую ветку из исходной ветки или коммита.

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"newBranchName": "feature/new-feature",
	"sourceBranchOrCommit": "main"
}

«Создать ветку 'feature/new-feature' из 'main' в 'frontend-app'».

`bb_clone_repo`

Клонирует репозиторий Bitbucket, идентифицированный workspaceSlug и repoSlug . Аргумент targetPath указывает родительский каталог, в который будет клонирован репозиторий.

ВАЖНО: targetPath ДОЛЖЕН быть абсолютным путем (например, /Users/me/projects ). Репозиторий будет клонирован в подкаталог, названный по имени репозитория в этом каталоге.

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"targetPath": "/Users/me/projects"
}

«Клонируйте репозиторий 'backend-api' в '/Users/me/projects'».

`bb_get_commit_history`

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

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api"
}

или (фильтр по ветке и пути):

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"revision": "develop",
	"path": "src/main/java/com/acme/service/UserService.java"
}

«Покажите мне историю коммитов для репозитория 'backend-api'». «Получите коммиты в ветке develop для UserService.java».

`bb_get_file`

Извлекает содержимое файла из репозитория Bitbucket.

Параметры:

workspaceSlug (строка, обязательно): Ярлык рабочей области, содержащий репозиторий.
repoSlug (строка, обязательно): Слаг репозитория, содержащий файл.
filePath (строка, обязательно): путь к файлу в репозитории (например, «src/app.js», «README.md»).
revision (строка, необязательно): Имя ветви, тег или хэш коммита для извлечения файла. Если не указано, используется ветвь репозитория по умолчанию.

Пример:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"filePath": "src/main/java/com/acme/service/Application.java",
	"revision": "main"
}

«Получить содержимое Application.java из основной ветки backend-api в acme-corp». «Показать мне pom.xml из последнего коммита ветки develop в репозитории 'coda-payments/api-gateway'».

Требуются учетные данные Bitbucket.

Интерфейс командной строки (CLI)

CLI использует kebab-case для команд (например, ls-workspaces ) и параметров (например, --workspace-slug ).

Быстрое использование с `npx`

npx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces
npx -y @aashari/mcp-server-atlassian-bitbucket get-repo \
  --workspace-slug acme-corp \
  --repo-slug backend-api
npx -y @aashari/mcp-server-atlassian-bitbucket ls-prs \
  --workspace-slug acme-corp \
  --repo-slug frontend-app \
  --state OPEN
npx -y @aashari/mcp-server-atlassian-bitbucket create-pr-comment \
  --workspace-slug acme-corp \
  --repo-slug frontend-app \
  --pr-id 42 \
  --content "Looks good to merge."
npx -y @aashari/mcp-server-atlassian-bitbucket get-commit-history \
  --workspace-slug acme-corp \
  --repo-slug backend-api \
  --revision develop
npx -y @aashari/mcp-server-atlassian-bitbucket create-branch \
  --workspace-slug acme-corp \
  --repo-slug frontend-app \
  --new-branch-name feature/new-stuff \
  --source-branch-or-commit main
npx -y @aashari/mcp-server-atlassian-bitbucket clone \
  --workspace-slug acme-corp \
  --repo-slug backend-api \
  --target-path ./cloned-projects
npx -y @aashari/mcp-server-atlassian-bitbucket get-file \
  --workspace-slug acme-corp \
  --repo-slug backend-api \
  --file-path "src/main/java/com/acme/service/Application.java" \
  --revision main

Установить глобально

npm install -g @aashari/mcp-server-atlassian-bitbucket

Затем выполните напрямую:

mcp-atlassian-bitbucket ls-workspaces
mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api

Откройте для себя больше возможностей CLI

Используйте --help , чтобы просмотреть флаги и использование всех доступных команд:

mcp-atlassian-bitbucket --help

Или получите подробную справку по конкретной команде:

mcp-atlassian-bitbucket ls-workspaces --help
mcp-atlassian-bitbucket get-workspace --help
mcp-atlassian-bitbucket ls-repos --help
mcp-atlassian-bitbucket get-repo --help
mcp-atlassian-bitbucket ls-prs --help
mcp-atlassian-bitbucket get-pr --help
mcp-atlassian-bitbucket ls-pr-comments --help
mcp-atlassian-bitbucket create-pr-comment --help
mcp-atlassian-bitbucket create-pr --help
mcp-atlassian-bitbucket search --help
mcp-atlassian-bitbucket get-commit-history --help
mcp-atlassian-bitbucket create-branch --help
mcp-atlassian-bitbucket clone --help
mcp-atlassian-bitbucket get-file --help

Лицензия

Лицензия ISC

Integrations