Каталог MCP
aashari/mcp-server-atlassian-bitbucket

aashari/mcp-server-atlassian-bitbucket

MCP сервер для подключения AI-ассистентов к Bitbucket: запрашивайте коммиты, пул-реквесты и код на естественном языке. Идеально для разработчиков, желающих автоматизировать обзор кода и управление ...

README

6 инструментов

Версии

Установить сервер

Connect AI to Your Bitbucket Repositories

Transform how you work with Bitbucket by connecting Claude, Cursor AI, and other AI assistants directly to your repositories, pull requests, and code. Get instant insights, automate code reviews, and streamline your development workflow.

What You Can Do

Ask AI about your code: "What's the latest commit in my main repository?"
Get PR insights: "Show me all open pull requests that need review"
Search your codebase: "Find all JavaScript files that use the authentication function"
Review code changes: "Compare the differences between my feature branch and main"
Manage pull requests: "Create a PR for my new-feature branch"
Automate workflows: "Add a comment to PR #123 with the test results"

Perfect For

Developers who want AI assistance with code reviews and repository management
Team Leads needing quick insights into project status and pull request activity
DevOps Engineers automating repository workflows and branch management
Anyone who wants to interact with Bitbucket using natural language

Инструменты были проиндексированы: 11.09.2026

bb_cloneвнешний мир

Клонирует репозиторий Bitbucket в вашу локальную файловую систему через SSH (предпочтительно) или HTTPS. Укажите repoSlug и targetPath (абсолютный путь). Клонируется в targetPath/repoSlug. SSH-ключи должны быть настроены; если они недоступны, используется HTTPS.

Клонировать репозиторий Bitbucket

Параметры

repoSlugstringобязательный
Repository name/slug to clone. This is the short name of the repository. Example: "project-api"
targetPathstringобязательный
Directory path where the repository will be cloned. IMPORTANT: Absolute paths are strongly recommended (e.g., "/home/user/projects" or "C:\Users\name\projects"). Relative paths will be resolved relative to the server's working directory, which may not be what you expect. The repository will be cloned into a subdirectory at targetPath/repoSlug. Make sure you have write permissions to this location.
workspaceSlugstring
Bitbucket workspace slug containing the repository. If not provided, the tool will use your default workspace (either configured via BITBUCKET_DEFAULT_WORKSPACE or the first workspace in your account). Example: "myteam"

bb_deleteидемпотентныйвнешний мир

Удаляет ресурсы Bitbucket. По умолчанию возвращает формат TOON. Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json") Типовые операции: 1. Удаление ветки: /repositories/{workspace}/{repo}/refs/branches/{branch_name} 2. Удаление комментария к PR: /repositories/{workspace}/{repo}/pullrequests/{pr_id}/comments/{comment_id} 3. Отклонение PR: /repositories/{workspace}/{repo}/pullrequests/{id}/decline 4. Снятие одобрения PR: /repositories/{workspace}/{repo}/pullrequests/{id}/approve 5. Удаление репозитория: /repositories/{workspace}/{repo} (осторожно: необратимо) Примечание: Большинство DELETE-эндпоинтов при успехе возвращают 204 No Content. Префикс /2.0 добавляется автоматически. Справочник API: https://developer.atlassian.com/cloud/bitbucket/rest/

Bitbucket DELETE запрос

Параметры

jqstring
JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "values[].{name: name, slug: slug}" (extract specific fields), "values[0]" (first result), "values[].name" (names only). See https://jmespath.org
outputFormatenum
Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax.
pathstringобязательный
The Bitbucket API endpoint path (without base URL). Must start with "/". Examples: "/workspaces", "/repositories/{workspace}/{repo_slug}", "/repositories/{workspace}/{repo_slug}/pullrequests/{id}"
queryParamsobject
Optional query parameters as key-value pairs. Examples: {"pagelen": "25", "page": "2", "q": "state="OPEN"", "fields": "values.title,values.state"}

bb_getтолько чтениеидемпотентныйвнешний мир

Читает любые данные Bitbucket. По умолчанию возвращает формат TOON (на 30–60% меньше токенов, чем JSON). ВАЖНО — оптимизация затрат: - ВСЕГДА используйте параметр jq, чтобы отфильтровать поля ответа. Неотфильтрованные ответы очень дороги! - Используйте параметр запроса pagelen, чтобы ограничить количество результатов (например, pagelen: "5"). - Если не уверены, какие поля доступны, сначала получите ОДИН элемент с pagelen: "1" и БЕЗ фильтра jq, чтобы изучить схему, а в следующих вызовах применяйте jq. Шаблон для изучения схемы: 1. Первый вызов: path: "/workspaces", queryParams: {"pagelen": "1"} (без jq) — изучите доступные поля. 2. Затем используйте: jq: "values[*].{slug: slug, name: name, uuid: uuid}" — извлекайте только то, что нужно. Формат вывода: TOON (по умолчанию, экономный по токенам) или JSON (outputFormat: "json"). Часто используемые пути: - /workspaces — список рабочих областей - /repositories/{workspace} — список репозиториев в рабочей области - /repositories/{workspace}/{repo} — детали репозитория - /repositories/{workspace}/{repo}/pullrequests — список пул-реквестов - /repositories/{workspace}/{repo}/pullrequests/{id} — детали пул-реквеста - /repositories/{workspace}/{repo}/pullrequests/{id}/comments — список комментариев к пул-реквесту - /repositories/{workspace}/{repo}/pullrequests/{id}/diff — diff пул-реквеста - /repositories/{workspace}/{repo}/refs/branches — список веток - /repositories/{workspace}/{repo}/commits — список коммитов - /repositories/{workspace}/{repo}/src/{commit}/{filepath} — содержимое файла - /repositories/{workspace}/{repo}/diff/{source}..{destination} — сравнение веток/коммитов Параметры запроса: pagelen (размер страницы), page (номер страницы), q (фильтр), sort (сортировка), fields (разреженный ответ). Примеры фильтров (параметр q): state="OPEN", source.branch.name="feature", title~"bug" Примеры JQ: values[*].slug, values[0], values[*].{name: name, uuid: uuid} Префикс /2.0 добавляется автоматически. Справочник по API: https://developer.atlassian.com/cloud/bitbucket/rest/

Bitbucket GET Request

Параметры

jqstring
JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "values[].{name: name, slug: slug}" (extract specific fields), "values[0]" (first result), "values[].name" (names only). See https://jmespath.org
outputFormatenum
Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax.
pathstringобязательный
The Bitbucket API endpoint path (without base URL). Must start with "/". Examples: "/workspaces", "/repositories/{workspace}/{repo_slug}", "/repositories/{workspace}/{repo_slug}/pullrequests/{id}"
queryParamsobject
Optional query parameters as key-value pairs. Examples: {"pagelen": "25", "page": "2", "q": "state="OPEN"", "fields": "values.title,values.state"}

bb_patchвнешний мир

Частично обновляет ресурсы Bitbucket. По умолчанию возвращает формат TOON. ВАЖНО — Оптимизация затрат: Используйте параметр jq для фильтрации полей ответа. Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json") Типовые операции: 1. Обновить название/описание PR: /repositories/{workspace}/{repo}/pullrequests/{id} body: {"title": "New title", "description": "Updated description"} 2. Обновить ревьюеров PR: /repositories/{workspace}/{repo}/pullrequests/{id} body: {"reviewers": [{"uuid": "{user-uuid}"}]} 3. Обновить свойства репозитория: /repositories/{workspace}/{repo} body: {"description": "New description"} 4. Обновить комментарий: /repositories/{workspace}/{repo}/pullrequests/{pr_id}/comments/{comment_id} body: {"content": {"raw": "Updated comment"}} Префикс /2.0 добавляется автоматически. Справочник API: https://developer.atlassian.com/cloud/bitbucket/rest/

PATCH-запрос Bitbucket

Параметры

bodyobjectобязательный
Request body as a JSON object. Structure depends on the endpoint. Example for PR: {"title": "My PR", "source": {"branch": {"name": "feature"}}}
jqstring
JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "values[].{name: name, slug: slug}" (extract specific fields), "values[0]" (first result), "values[].name" (names only). See https://jmespath.org
outputFormatenum
Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax.
pathstringобязательный
The Bitbucket API endpoint path (without base URL). Must start with "/". Examples: "/workspaces", "/repositories/{workspace}/{repo_slug}", "/repositories/{workspace}/{repo_slug}/pullrequests/{id}"
queryParamsobject
Optional query parameters as key-value pairs. Examples: {"pagelen": "25", "page": "2", "q": "state="OPEN"", "fields": "values.title,values.state"}

bb_postвнешний мир

Создаёт ресурсы Bitbucket. По умолчанию возвращает TOON-формат (эффективен по токенам). ВАЖНО - Оптимизация затрат: - Используйте параметр jq, чтобы извлечь только нужные поля из ответа (например, jq: "{id: id, title: title}") - Нефильтрованные ответы содержат все метаданные и стоят дорого! Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json") Типовые операции: 1. Создать PR: /repositories/{workspace}/{repo}/pullrequests body: {"title": "...", "source": {"branch": {"name": "feature"}}, "destination": {"branch": {"name": "main"}}} 2. Добавить комментарий к PR: /repositories/{workspace}/{repo}/pullrequests/{id}/comments body: {"content": {"raw": "Текст комментария"}} 3. Одобрить PR: /repositories/{workspace}/{repo}/pullrequests/{id}/approve body: {} 4. Запросить изменения: /repositories/{workspace}/{repo}/pullrequests/{id}/request-changes body: {} 5. Слить PR: /repositories/{workspace}/{repo}/pullrequests/{id}/merge body: {"merge_strategy": "squash"} (стратегии: merge_commit, squash, fast_forward) Префикс /2.0 добавляется автоматически. Справочник API: https://developer.atlassian.com/cloud/bitbucket/rest/

Bitbucket POST-запрос

Параметры

bodyobjectобязательный
Request body as a JSON object. Structure depends on the endpoint. Example for PR: {"title": "My PR", "source": {"branch": {"name": "feature"}}}
jqstring
JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "values[].{name: name, slug: slug}" (extract specific fields), "values[0]" (first result), "values[].name" (names only). See https://jmespath.org
outputFormatenum
Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax.
pathstringобязательный
The Bitbucket API endpoint path (without base URL). Must start with "/". Examples: "/workspaces", "/repositories/{workspace}/{repo_slug}", "/repositories/{workspace}/{repo_slug}/pullrequests/{id}"
queryParamsobject
Optional query parameters as key-value pairs. Examples: {"pagelen": "25", "page": "2", "q": "state="OPEN"", "fields": "values.title,values.state"}

bb_putидемпотентныйвнешний мир

Заменяет ресурсы Bitbucket (полное обновление). По умолчанию возвращает формат TOON. ВАЖНО - Оптимизация затрат: - Используйте параметр jq, чтобы извлекать только нужные поля из ответа - Пример: jq: "{uuid: uuid, name: name}" Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json") Типовые операции: 1. Обновление репозитория: /repositories/{workspace}/{repo} тело: {"description": "...", "is_private": true, "has_issues": true} 2. Создание/обновление файла: /repositories/{workspace}/{repo}/src Примечание: для загрузки файлов используйте multipart form data (сложно - для метаданных лучше использовать PATCH) 3. Обновление ограничения ветки: /repositories/{workspace}/{repo}/branch-restrictions/{id} тело: {"kind": "push", "pattern": "main", "users": [{"uuid": "..."}]} Префикс /2.0 добавляется автоматически. Справочник API: https://developer.atlassian.com/cloud/bitbucket/rest/

Bitbucket PUT-запрос

Параметры

bodyobjectобязательный
Request body as a JSON object. Structure depends on the endpoint. Example for PR: {"title": "My PR", "source": {"branch": {"name": "feature"}}}
jqstring
JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "values[].{name: name, slug: slug}" (extract specific fields), "values[0]" (first result), "values[].name" (names only). See https://jmespath.org
outputFormatenum
Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax.
pathstringобязательный
The Bitbucket API endpoint path (without base URL). Must start with "/". Examples: "/workspaces", "/repositories/{workspace}/{repo_slug}", "/repositories/{workspace}/{repo_slug}/pullrequests/{id}"
queryParamsobject
Optional query parameters as key-value pairs. Examples: {"pagelen": "25", "page": "2", "q": "state="OPEN"", "fields": "values.title,values.state"}

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@aashari/mcp-server-atlassian-bitbucket"
  ],
  "env": {
    "ATLASSIAN_USER_EMAIL": "your.email@company.com",
    "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер подключает AI-помощников к репозиториям Bitbucket. Он решает задачу взаимодействия с кодом, пулл-реквестами и рабочими процессами через обычные запросы на русском или английском. Вместо ручного переключения между инструментами разработчик может попросить AI показать последний коммит, найти нужные файлы, создать PR или оставить комментарий. Сервер даёт командам быстрый доступ к статусу проектов и автоматизирует рутинные операции с репозиториями.

Что он умеет?

Сервер взаимодействует с Bitbucket Cloud через универсальные HTTP-инструменты: читает данные (GET), создает (POST), заменяет (PUT), частично обновляет (PATCH) и удаляет (DELETE). С их помощью работает с репозиториями, pull request'ами, коммитами и кодом. Дополнительно клонирует репозитории на локальный диск через SSH или HTTPS. Ответы можно фильтровать через jq и выводить в компактном формате TOON или JSON.

Информация о сервере

Номер в рейтинге: #173
Звезд на Github: 162
Форков на Github: 61
Загрузок: 73 048
Язык реализации: TypeScript
Лицензия: неизвестно
Официальный сервер: Нет
Дата обновления данных: 10.09 в 21:50
Идентификатор: c5Ln-MKqSMnzmloK
Категории: Git, Инструменты для разработчиков, Исследования и данные, Управление проектами