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

JaviMaligno/mcp-server-bitbucket

Name: JaviMaligno/mcp-server-bitbucket
Availability: InStock
Author: javimaligno

MCP сервер для интеграции с Bitbucket: управление репозиториями, пулл-реквестами и пайплайнами. Работает с Claude Code, Cursor и любыми MCP-клиентами. Также доступны CI/CD, вебхуки и управление ветками.

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

README

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

Версии

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

Bitbucket MCP Server

MCP server for Bitbucket API operations. Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Language Versions

This repository contains both TypeScript and Python implementations:

Version	Directory	Status	Installation
TypeScript	`/typescript`	✅ Recommended (Smithery)	`npm install -g mcp-server-bitbucket`
Python	`/python`	✅ Stable	`pipx install mcp-server-bitbucket`

Note: The TypeScript version is used for Smithery deployments. Both versions provide identical functionality.

Features

Repositories: get, create, delete, list, update (move to project, rename)
Pull Requests: create, get, list, merge, approve, decline, request changes, comments, diff
Pipelines: trigger, get status, list, view logs, stop
Branches: list, get
Projects: list, get
Commits: list, get details, compare/diff between branches
Commit Statuses: get build statuses, create status (CI/CD integration)
Deployments: list environments, get environment details, deployment history
Webhooks: list, create, get, delete
Tags: list, create, delete
Branch Restrictions: list, create, delete branch protection rules
Source Browsing: read files, list directories without cloning
Repository Permissions: manage user and group permissions
Pipeline Variables: manage CI/CD environment variables
MCP Prompts: reusable workflow templates (code review, release notes, etc.)
MCP Resources: browsable workspace data

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

add_pr_comment

Добавляет комментарий к pull request. Поддерживает общие и построчные комментарии.

Параметры

contentstringобязательный
Содержимое комментария (поддерживается Markdown)
file_pathstring
Путь к файлу для встроенного комментария (необязательно)
linenumber
Номер строки для инлайн-комментария (необязательно, требует file_path)
pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

approve_pr

Одобрить pull request

Параметры

pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

compare_commits

Сравнивает два коммита или ветки и показывает изменённые файлы.

Параметры

basestringобязательный
Хэш базового коммита или имя ветки
headstringобязательный
Хэш коммита HEAD или имя ветки
repo_slugstringобязательный
Слаг репозитория

create_branch_restriction

Создаёт ограничение ветки (правило защиты).

Параметры

branch_match_kindstring
Как сопоставить ветки: "glob" или "branching_model"
branch_typestring
Тип ветки при использовании branching_model: development, production, feature и т.д.
kindstringобязательный
Тип ограничения: push, force, delete, restrict_merges, require_passing_builds_to_merge, require_approvals_to_merge и т. д.
patternstring
Шаблон ветки (например, «main», «release/*»). Обязателен для glob-сопоставления.
repo_slugstringобязательный
Слаг репозитория
valuenumber
Числовое значение (например, количество требуемых одобрений)

create_commit_status

Создаёт статус сборки для коммита. Использует это для отчёта о статусе CI/CD из внешних систем.

Параметры

commitstringобязательный
Хэш коммита
descriptionstring
Описание статуса (необязательно)
keystringобязательный
Уникальный идентификатор этого статуса.
namestring
Отображаемое имя статуса (необязательно)
repo_slugstringобязательный
Слаг репозитория
statestringобязательный
Состояние статуса: SUCCESSFUL, FAILED, INPROGRESS, STOPPED
urlstring
URL, ведущий к деталям сборки (необязательно)

create_pipeline_variable

Создаёт переменную пайплайна.

Параметры

keystringобязательный
Имя переменной
repo_slugstringобязательный
Слаг репозитория
securedboolean
Шифрует значение (защищённые переменные нельзя прочитать обратно).
valuestringобязательный
Значение переменной.

create_pull_request

Создаёт pull request в репозитории Bitbucket.

Параметры

close_source_branchboolean
Удаляет исходную ветку после слияния.
descriptionstring
Описание PR в Markdown
destination_branchstring
Целевая ветка (по умолчанию: main)
repo_slugstringобязательный
Слаг репозитория
source_branchstringобязательный
Имя исходной ветки
titlestringобязательный
Заголовок PR.

create_repository

Создаёт новый репозиторий Bitbucket.

Параметры

descriptionstring
Описание репозитория
is_privateboolean
Определяет, приватный ли репозиторий (по умолчанию: true)
project_keystring
Ключ проекта, в котором создаётся репозиторий (необязательно)
repo_slugstringобязательный
Слаг репозитория (строчными буквами, без пробелов)

create_tag

Создать новый тег в репозитории.

Параметры

messagestring
Необязательное сообщение тега (для аннотированных тегов)
namestringобязательный
Имя тега (например, "v1.0.0")
repo_slugstringобязательный
Слаг репозитория
targetstringобязательный
Хэш коммита или имя ветки для тега

create_webhook

Создать вебхук для репозитория.

Параметры

activeboolean
Активен ли webhook (по умолчанию: true)
descriptionstring
Описание вебхука (необязательно)
eventsstring[]обязательный
Список событий (например, repo:push, pullrequest:created, pullrequest:merged)
repo_slugstringобязательный
Слаг репозитория
urlstringобязательный
URL для вызова при возникновении событий

decline_pr

Отклонить (закрыть без слияния) pull request.

Параметры

pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

delete_branch_restriction

Удалить ограничение ветки

Параметры

repo_slugstringобязательный
Слаг репозитория
restriction_idnumberобязательный
Идентификатор ограничения

delete_group_permission

Удалить явное разрешение группы из репозитория.

Параметры

group_slugstringобязательный
Слаг группы
repo_slugstringобязательный
Слаг репозитория

delete_pipeline_variable

Удалить переменную пайплайна.

Параметры

repo_slugstringобязательный
Слаг репозитория
variable_uuidstringобязательный
Переменная UUID

delete_repository

Удалить репозиторий Bitbucket. ПРЕДУПРЕЖДЕНИЕ: это действие необратимо!

Параметры

repo_slugstringобязательный
Идентификатор репозитория для удаления

delete_tag

Удалить тег из репозитория.

Параметры

repo_slugstringобязательный
Слаг репозитория
tag_namestringобязательный
Имя тега для удаления.

delete_user_permission

Удалить явное разрешение пользователя из репозитория.

Параметры

repo_slugstringобязательный
Слаг репозитория
selected_userstringобязательный
Идентификатор аккаунта пользователя или UUID

delete_webhook

Удалить webhook.

Параметры

repo_slugstringобязательный
Слаг репозитория
webhook_uuidstringобязательный
Webhook UUID

get_branch

Получить информацию о конкретной ветке.

Параметры

branch_namestringобязательный
Название ветки
repo_slugstringобязательный
Слаг репозитория

get_commit

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

Параметры

commitstringобязательный
Хэш коммита (полный или короткий)
repo_slugstringобязательный
Слаг репозитория

get_commit_statuses

Получить статусы сборки/CI для коммита.

Параметры

commitstringобязательный
Хэш коммита
limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

get_environment

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

Параметры

environment_uuidstringобязательный
UUID окружения
repo_slugstringобязательный
Слаг репозитория

get_file_content

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

Параметры

pathstringобязательный
Путь к файлу (например, "src/main.py", "README.md")
refstring
Ветка, тег или хэш коммита (по умолчанию: "main")
repo_slugstringобязательный
Слаг репозитория

get_group_permission

Получить разрешение конкретной группы для репозитория.

Параметры

group_slugstringобязательный
Слаг группы
repo_slugstringобязательный
Слаг репозитория

get_pipeline

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

Параметры

pipeline_uuidstringобязательный
UUID пайплайна
repo_slugstringобязательный
Слаг репозитория

get_pipeline_config

Получить конфигурацию пайплайна для репозитория (проверить, включены ли пайплайны).

Параметры

repo_slugstringобязательный
Слаг репозитория

get_pipeline_logs

Получает логи выполнения конвейера. Если step_uuid не указан, возвращает список шагов.

Параметры

pipeline_uuidstringобязательный
UUID пайплайна
repo_slugstringобязательный
Слаг репозитория
step_uuidstring
Step UUID (необязательно, берется из списка шагов)

get_pipeline_variable

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

Параметры

repo_slugstringобязательный
Слаг репозитория
variable_uuidstringобязательный
Переменная UUID

get_pr_diff

Получить diff пул-реквеста.

Параметры

pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

get_project

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

Параметры

project_keystringобязательный
Ключ проекта (например, "DS", "PROJ")

get_pull_request

Получить информацию о pull request.

Параметры

pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

get_repository

Получить информацию о репозитории Bitbucket.

Параметры

repo_slugstringобязательный
Слаг репозитория (например, "anzsic_classifier")

get_user_permission

Получает разрешение конкретного пользователя для репозитория.

Параметры

repo_slugstringобязательный
Слаг репозитория
selected_userstringобязательный
Идентификатор аккаунта пользователя или UUID

get_webhook

Получить сведения о конкретном webhook.

Параметры

repo_slugstringобязательный
Слаг репозитория
webhook_uuidstringобязательный
Webhook UUID

list_branches

Вывести список веток в репозитории.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_branch_restrictions

Перечислить ограничения веток (правила защиты) в репозитории.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_commits

Вывести список коммитов в репозитории.

Параметры

branchstring
Фильтр по имени ветки (необязательно).
limitnumber
Максимальное количество результатов (по умолчанию: 50)
pathstring
Фильтр по пути к файлу - только коммиты, изменившие этот путь (необязательно)
repo_slugstringобязательный
Слаг репозитория

list_deployment_history

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

Параметры

environment_uuidstringобязательный
UUID окружения
limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_directory

Вывести содержимое каталога в репозитории. Просматривать структуру репозитория без клонирования.

Параметры

limitnumber
Максимум записей (по умолчанию: 100)
pathstring
Путь к каталогу (пустая строка для корня)
refstring
Ветка, тег или хэш коммита (по умолчанию: "main")
repo_slugstringобязательный
Слаг репозитория

list_environments

Выведи список сред развертывания для репозитория.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_group_permissions

Вывести групповые разрешения для репозитория.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_pipelines

Вывести список последних запусков пайплайна для репозитория.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_pipeline_variables

Список переменных пайплайна для репозитория.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_pr_comments

Показать комментарии к пулл-реквесту.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

list_projects

Вывести список проектов в рабочей области.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)

list_pull_requests

Выведи список пул-реквестов в репозитории.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 20, максимум: 100)
repo_slugstringобязательный
Слаг репозитория
statestring
Фильтровать по состоянию: OPEN, MERGED, DECLINED, SUPERSEDED

list_repositories

Выводит список репозиториев в рабочем пространстве и ищет по ним.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 5, макс.: 20)
project_keystring
Фильтр по ключу проекта (необязательно)
querystring
Расширенный синтаксис запросов Bitbucket (необязательно). Примеры: name ~ "api", is_private = false
searchstring
Простой поисковый запрос для имени репозитория (необязательный). Использует нечёткое сопоставление.

list_tags

Вывести список тегов в репозитории.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_user_permissions

Вывести список разрешений пользователя для репозитория.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

list_webhooks

Выводит список вебхуков, настроенных для репозитория.

Параметры

limitnumber
Максимальное количество результатов (по умолчанию: 50)
repo_slugstringобязательный
Слаг репозитория

merge_pull_request

Сливает pull request.

Параметры

close_source_branchboolean
Удаляет исходную ветку после слияния.
merge_strategystring
merge_commit, squash или fast_forward
messagestring
Необязательное сообщение для merge-коммита.
pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

request_changes_pr

Запросить изменения в pull request.

Параметры

pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

stop_pipeline

Останавливает запущенный пайплайн.

Параметры

pipeline_uuidstringобязательный
UUID пайплайна
repo_slugstringобязательный
Слаг репозитория

trigger_pipeline

Запустить конвейер. Поддерживает пользовательские конвейеры (из раздела "custom:" в файле bitbucket-pipelines.yml) и триггеры на основе коммитов.

Параметры

branchstring
Ветка, на которой запускается конвейер (по умолчанию: main). Несовместимо с commit.
commitstring
Хэш коммита, на котором запускается пайплайн. Не может использоваться одновременно с веткой.
custom_pipelinestring
Название кастомного пайплайна из секции "custom:" (например, "deploy-staging", "dry-run")
repo_slugstringобязательный
Слаг репозитория
variablesobject[]
Переменные пайплайна. Могут быть массивом {key, value, secured?} или простым объектом {key: value} для обратной совместимости.

unapprove_pr

Отозвать своё одобрение из пул-реквеста.

Параметры

pr_idnumberобязательный
Идентификатор pull request
repo_slugstringобязательный
Слаг репозитория

update_group_permission

Обновить или добавить разрешение группы для репозитория.

Параметры

group_slugstringобязательный
Слаг группы
permissionstringобязательный
Уровень прав доступа: «чтение», «запись» или «админ»
repo_slugstringобязательный
Слаг репозитория

update_pipeline_config

Обновить конфигурацию пайплайна для репозитория (включить или отключить пайплайны).

Параметры

enabledbooleanобязательный
Включить или отключить пайплайны
repo_slugstringобязательный
Слаг репозитория

update_pipeline_variable

Обновить значение переменной пайплайна.

Параметры

repo_slugstringобязательный
Слаг репозитория
valuestringобязательный
Новое значение переменной
variable_uuidstringобязательный
Переменная UUID

update_repository

Обновить настройки репозитория (проект, видимость, описание, имя).

Параметры

descriptionstring
Обновляет описание (необязательно).
is_privateboolean
Изменить видимость (необязательно)
namestring
Переименовывает репозиторий (необязательно)
project_keystring
Переместить в другой проект (необязательно)
repo_slugstringобязательный
Слаг репозитория

update_user_permission

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

Параметры

permissionstringобязательный
Уровень прав доступа: «чтение», «запись» или «админ»
repo_slugstringобязательный
Слаг репозитория
selected_userstringобязательный
Идентификатор аккаунта пользователя или UUID

`0.12.0`основная	11.03.2026
`0.11.0`	21.01.2026

Выберите клиент, чтобы установить JaviMaligno/mcp-server-bitbucket:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "javimaligno-mcp-server-bitbucket-5qb7glswft": {
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "javimaligno-mcp-server-bitbucket-5qb7glswft": {
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "javimaligno-mcp-server-bitbucket-5qb7glswft": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"javimaligno-mcp-server-bitbucket-5qb7glswft\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"mcp-server-bitbucket\"],\"env\":{\"BITBUCKET_WORKSPACE\":\"your-workspace\",\"BITBUCKET_EMAIL\":\"your-email@example.com\",\"BITBUCKET_API_TOKEN\":\"your-api-token\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "javimaligno-mcp-server-bitbucket-5qb7glswft": {
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add javimaligno-mcp-server-bitbucket-5qb7glswft --env BITBUCKET_WORKSPACE=your-workspace --env BITBUCKET_EMAIL=your-email@example.com --env BITBUCKET_API_TOKEN=your-api-token -- npx mcp-server-bitbucket

Либо через JSON-конфиг:

claude mcp add-json javimaligno-mcp-server-bitbucket-5qb7glswft "{\"command\":\"npx\",\"args\":[\"mcp-server-bitbucket\"],\"env\":{\"BITBUCKET_WORKSPACE\":\"your-workspace\",\"BITBUCKET_EMAIL\":\"your-email@example.com\",\"BITBUCKET_API_TOKEN\":\"your-api-token\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add javimaligno-mcp-server-bitbucket-5qb7glswft --env BITBUCKET_WORKSPACE=your-workspace --env BITBUCKET_EMAIL=your-email@example.com --env BITBUCKET_API_TOKEN=your-api-token -- npx mcp-server-bitbucket

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.javimaligno-mcp-server-bitbucket-5qb7glswft]
command = "npx"
args = ["mcp-server-bitbucket"]

[mcp_servers.javimaligno-mcp-server-bitbucket-5qb7glswft.env]
BITBUCKET_WORKSPACE = "your-workspace"
BITBUCKET_EMAIL = "your-email@example.com"
BITBUCKET_API_TOKEN = "your-api-token"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите JaviMaligno/mcp-server-bitbucket, а в поле команды запуска — строку ниже:

npx mcp-server-bitbucket

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "javimaligno-mcp-server-bitbucket-5qb7glswft": {
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "javimaligno-mcp-server-bitbucket-5qb7glswft": {
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например javimaligno-mcp-server-bitbucket-5qb7glswft.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: javimaligno-mcp-server-bitbucket-5qb7glswft
    command: npx
    args:
      - "mcp-server-bitbucket"
    env:
      BITBUCKET_WORKSPACE: your-workspace
      BITBUCKET_EMAIL: your-email@example.com
      BITBUCKET_API_TOKEN: your-api-token

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "javimaligno-mcp-server-bitbucket-5qb7glswft": {
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

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

{
  "command": "npx",
  "args": [
    "mcp-server-bitbucket"
  ],
  "env": {
    "BITBUCKET_WORKSPACE": "your-workspace",
    "BITBUCKET_EMAIL": "your-email@example.com",
    "BITBUCKET_API_TOKEN": "your-api-token"
  }
}

Нужен npx

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

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