Servidor Bitbucket MCP

Servidor MCP (Protocolo de Contexto de Modelo) para la gestión de solicitudes de extracción de Bitbucket Server. Este servidor proporciona herramientas y recursos para interactuar con la API de Bitbucket Server mediante el protocolo MCP.

insignia de herrería

Requisitos

Node.js >= 16

Related MCP server: GitHub MCP Server

Instalación

Instalación mediante herrería

Para instalar Bitbucket Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

Instalación manual

npm install

Construir

npm run build

Características

El servidor proporciona las siguientes herramientas para la integración de Bitbucket Server:

`create_pull_request`

Crea una nueva solicitud de extracción.

Parámetros:

project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
repository (obligatorio): slug del repositorio
title (obligatorio): Título de PR
description : Descripción de relaciones públicas
sourceBranch (obligatorio): Nombre de la rama de origen
targetBranch (obligatorio): nombre de la rama de destino
reviewers : Matriz de nombres de usuario de revisores

`get_pull_request`

Recupera información detallada sobre una solicitud de extracción específica.

Parámetros:

project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
repository (obligatorio): slug del repositorio
prId (obligatorio): ID de la solicitud de extracción

`merge_pull_request`

Fusiona una solicitud de extracción.

Parámetros:

project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
repository (obligatorio): slug del repositorio
prId (obligatorio): ID de la solicitud de extracción
message : Mensaje de confirmación de fusión
strategy : Una de:
- merge-commit (predeterminado)
- squash
- fast-forward

`decline_pull_request`

Rechaza una solicitud de extracción.

Parámetros:

project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
repository (obligatorio): slug del repositorio
prId (obligatorio): ID de la solicitud de extracción
message : Motivo del rechazo

`add_comment`

Agrega un comentario a una solicitud de extracción.

Parámetros:

project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
repository (obligatorio): slug del repositorio
prId (obligatorio): ID de la solicitud de extracción
text (obligatorio): Texto del comentario
parentId : ID del comentario principal para las respuestas

`get_diff`

Recupera la diferencia para una solicitud de extracción.

Parámetros:

project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
repository (obligatorio): slug del repositorio
prId (obligatorio): ID de la solicitud de extracción
contextLines : Número de líneas de contexto (predeterminado: 10)

`get_reviews`

Obtiene el historial de revisión de una solicitud de extracción, incluidas las aprobaciones y revisiones.

Parámetros:

project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
repository (obligatorio): slug del repositorio
prId (obligatorio): ID de la solicitud de extracción

Dependencias

@modelcontextprotocol/sdk - SDK para la implementación del protocolo MCP
axios - Cliente HTTP para solicitudes API
winston - Marco de registro

Configuración

El servidor requiere configuración en el archivo de configuración MCP de VSCode. A continuación, se muestra un ejemplo de configuración:

{ "mcpServers": { "bitbucket": { "command": "node", "args": ["/path/to/bitbucket-server/build/index.js"], "env": { "BITBUCKET_URL": "https://your-bitbucket-server.com", // Authentication (choose one): // Option 1: Personal Access Token "BITBUCKET_TOKEN": "your-access-token", // Option 2: Username/Password "BITBUCKET_USERNAME": "your-username", "BITBUCKET_PASSWORD": "your-password", // Optional: Default project "BITBUCKET_DEFAULT_PROJECT": "your-default-project" } } } }

Variables de entorno

BITBUCKET_URL (obligatorio): URL base de su instancia de Bitbucket Server
Autenticación (se requiere uno de los siguientes):
- BITBUCKET_TOKEN : Token de acceso personal
- BITBUCKET_USERNAME y BITBUCKET_PASSWORD : Credenciales de autenticación básicas
BITBUCKET_DEFAULT_PROJECT : Clave de proyecto predeterminada que se utilizará cuando no se especifique en las llamadas de herramientas