VOOZH about

URL: https://glama.ai/mcp/servers/icy-r/bitbucket-mcp?locale=ru-RU

⇱ Bitbucket MCP by icy-r | Glama

Bitbucket MCP

👁 npm version
👁 License: MIT

Сервер Model Context Protocol (MCP) для Bitbucket Cloud. Позволяет ИИ-ассистентам управлять репозиториями, запросами на слияние, пайплайнами и многим другим.

Установка

Вариант 1: Использование npx (рекомендуется)

Установка не требуется. Запустите напрямую:

npx @icy-r/bitbucket-mcp

Вариант 2: Глобальная установка

npm install -g @icy-r/bitbucket-mcp
bitbucket-mcp

Вариант 3: Локальная разработка

git clone https://github.com/icy-r/bitbucket-mcp.git
cd bitbucket-mcp
pnpm install
pnpm build
node dist/index.js

Related MCP server: Atlassian Bitbucket MCP Server

Настройка клиента MCP

Cursor IDE

Добавьте в настройки MCP Cursor (~/.cursor/mcp.json, в Windows: %USERPROFILE%\.cursor\mcp.json):

Использование npx (рекомендуется):

{
 "mcpServers": {
 "bitbucket": {
 "command": "npx",
 "args": ["-y", "@icy-r/bitbucket-mcp"],
 "env": {
 "BITBUCKET_AUTH_METHOD": "api_token",
 "BITBUCKET_USER_EMAIL": "your.email@example.com",
 "BITBUCKET_API_TOKEN": "your_api_token"
 }
 }
 }
}

Использование локальной сборки:

{
 "mcpServers": {
 "bitbucket": {
 "command": "node",
 "args": ["D:\\path\\to\\bitbucket-mcp\\dist\\index.js"],
 "env": {
 "BITBUCKET_AUTH_METHOD": "api_token",
 "BITBUCKET_USER_EMAIL": "your.email@example.com",
 "BITBUCKET_API_TOKEN": "your_api_token"
 }
 }
 }
}

Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json в macOS, %APPDATA%\Claude\claude_desktop_config.json в Windows):

{
 "mcpServers": {
 "bitbucket": {
 "command": "npx",
 "args": ["-y", "@icy-r/bitbucket-mcp"],
 "env": {
 "BITBUCKET_AUTH_METHOD": "api_token",
 "BITBUCKET_USER_EMAIL": "your.email@example.com",
 "BITBUCKET_API_TOKEN": "your_api_token"
 }
 }
 }
}

Другие клиенты MCP

Сервер соответствует стандарту MCP и работает с любым совместимым клиентом. Используйте шаблон конфигурации выше, при необходимости корректируя пути для вашей платформы.

Аутентификация

Токен API (рекомендуется)

  1. Перейдите в Bitbucket API Tokens

  2. Создайте новый токен с необходимыми разрешениями

  3. Установите переменные окружения:

BITBUCKET_AUTH_METHOD=api_token
BITBUCKET_USER_EMAIL=your.email@example.com
BITBUCKET_API_TOKEN=your_api_token

Пароль приложения (App Password)

  1. Перейдите в Bitbucket App Passwords

  2. Создайте новый пароль приложения с необходимыми разрешениями

  3. Используйте метод аутентификации basic с вашим именем пользователя и паролем приложения

Переменные окружения

Переменная

Описание

Обязательно

BITBUCKET_AUTH_METHOD

api_token, oauth, basic

Да

BITBUCKET_USER_EMAIL

Ваш email в Atlassian

Для api_token

BITBUCKET_API_TOKEN

Токен API

Для api_token

BITBUCKET_USERNAME

Имя пользователя Bitbucket

Для basic auth

BITBUCKET_APP_PASSWORD

Пароль приложения

Для basic auth

BITBUCKET_WORKSPACE

Рабочее пространство по умолчанию (используется, если в вызове инструмента пропущен workspace)

Нет

BITBUCKET_OUTPUT_FORMAT

json, toon, compact

Нет

Доступные инструменты

Инструмент

Действия

bitbucket_workspaces

list, get, list_projects, list_members

bitbucket_repositories

list, get, create, delete, fork, get_file, list_source

bitbucket_pull_requests

list, get, create, update, merge, approve, unapprove, decline, list_comments, add_comment, get_diff

bitbucket_branches

list_branches, get_branch, create_branch, delete_branch, list_tags, get_tag, create_tag

bitbucket_commits

list, get, get_diff, get_diffstat

bitbucket_pipelines

list, get, trigger, trigger_custom, stop, list_steps, get_step, get_logs, get_config, set_enabled, list_variables, get_variable, create_variable, update_variable, delete_variable

bitbucket_issues

list, get, create, update, delete, list_comments, add_comment, vote, unvote, watch, unwatch

bitbucket_webhooks

list, get, create, update, delete, list_workspace, get_workspace, create_workspace, update_workspace, delete_workspace

Форматы вывода

Управляйте детализацией ответа с помощью параметра format:

Формат

Описание

Экономия токенов

json

Полный вывод JSON

0%

toon

Компактный формат TOON

~50%

compact

Только основные поля

~76%

Пример использования:

{ "action": "list", "workspace": "my-workspace", "format": "compact" }

Примеры

Список репозиториев в рабочем пространстве

{
 "action": "list",
 "workspace": "my-workspace"
}

Создание запроса на слияние (pull request)

{
 "action": "create",
 "workspace": "my-workspace",
 "repo_slug": "my-repo",
 "title": "Feature: Add new functionality",
 "source_branch": "feature/new-feature",
 "destination_branch": "main"
}

Запуск пайплайна

{
 "action": "trigger",
 "workspace": "my-workspace",
 "repo_slug": "my-repo",
 "branch_name": "main"
}

Рабочее пространство по умолчанию

Установите BITBUCKET_WORKSPACE в вашем окружении, чтобы пропускать параметр workspace при каждом вызове инструмента:

{ "action": "list", "repo_slug": "my-repo" }

Разработка

# Clone the repository
git clone https://github.com/icy-r/bitbucket-mcp.git
cd bitbucket-mcp

# Install dependencies
pnpm install

# Build
pnpm build

# Run tests
pnpm test

# Run in development mode (watch)
pnpm dev

# Lint and format
pnpm lint
pnpm format

Требования

  • Node.js >= 20.0.0

  • pnpm (для разработки)

Лицензия

MIT

A
license - permissive license
A
quality
B
maintenance

Maintenance

–Maintainers
–Response time
3wRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/icy-r/bitbucket-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server