VOOZH about

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

⇱ Bitbucket MCP by icy-r | Glama

Bitbucket MCP

👁 npm version
👁 License: MIT

Un servidor del Protocolo de Contexto de Modelos (MCP) para Bitbucket Cloud. Permite a los asistentes de IA gestionar repositorios, solicitudes de extracción, pipelines y más.

Instalación

Opción 1: Usando npx (Recomendado)

No requiere instalación. Ejecutar directamente:

npx @icy-r/bitbucket-mcp

Opción 2: Instalación global

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

Opción 3: Desarrollo local

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

Configuración del cliente MCP

Cursor IDE

Añadir a la configuración de MCP de Cursor (~/.cursor/mcp.json en Windows: %USERPROFILE%\.cursor\mcp.json):

Usando npx (Recomendado):

{
 "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"
 }
 }
 }
}

Usando compilación local:

{
 "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

Añadir a la configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en 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"
 }
 }
 }
}

Otros clientes MCP

El servidor sigue el estándar MCP y funciona con cualquier cliente compatible. Utilice el patrón de configuración anterior, ajustando las rutas según sea necesario para su plataforma.

Autenticación

Token de API (Recomendado)

  1. Vaya a Tokens de API de Bitbucket

  2. Cree un nuevo token con los permisos necesarios

  3. Establezca las variables de entorno:

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

Contraseña de aplicación

  1. Vaya a Contraseñas de aplicación de Bitbucket

  2. Cree una nueva contraseña de aplicación con los permisos necesarios

  3. Utilice el método de autenticación basic con su nombre de usuario y contraseña de aplicación

Variables de entorno

Variable

Descripción

Requerido

BITBUCKET_AUTH_METHOD

api_token, oauth, basic

Sí

BITBUCKET_USER_EMAIL

Su correo electrónico de Atlassian

Para api_token

BITBUCKET_API_TOKEN

Token de API

Para api_token

BITBUCKET_USERNAME

Nombre de usuario de Bitbucket

Para auth basic

BITBUCKET_APP_PASSWORD

Contraseña de aplicación

Para auth basic

BITBUCKET_WORKSPACE

Espacio de trabajo predeterminado (usado si se omite workspace)

No

BITBUCKET_OUTPUT_FORMAT

json, toon, compact

No

Herramientas disponibles

Herramienta

Acciones

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

Formatos de salida

Controle la verbosidad de la respuesta con el parámetro format:

Formato

Descripción

Ahorro de tokens

json

Salida JSON completa

0%

toon

Formato TOON compacto

~50%

compact

Solo campos esenciales

~76%

Ejemplo de uso:

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

Ejemplos

Listar repositorios en un espacio de trabajo

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

Crear una solicitud de extracción

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

Activar un pipeline

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

Espacio de trabajo predeterminado

Establezca BITBUCKET_WORKSPACE en su entorno para omitir el parámetro workspace en cada llamada a la herramienta:

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

Desarrollo

# 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

Requisitos

  • Node.js >= 20.0.0

  • pnpm (para desarrollo)

Licencia

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