MCP de Bitbucket Server

Servidor MCP (Model Context Protocol) para la gestión de solicitudes de extracción (Pull Requests) de Bitbucket Server. Este servidor proporciona herramientas y recursos para interactuar con la API de Bitbucket Server a través del protocolo MCP.

✨ Nuevas funciones

• 🔧 Encabezados HTTP personalizados: Añada encabezados personalizados a todas las solicitudes mediante la variable de entorno BITBUCKET_CUSTOM_HEADERS (útil para tokens de Zero Trust o proxies)

• 📋 Descubrimiento de PR: Liste y filtre solicitudes de extracción por estado, autor o dirección usando list_pull_requests (corrige #14)

• 🌿 Gestión de ramas: Liste ramas con detección de rama predeterminada usando list_branches, elimine ramas fusionadas con delete_branch

• 📝 Historial de confirmaciones (commits): Explore el historial de confirmaciones con filtrado por rama y autor usando list_commits

• ✅ Aprobación de PR: Apruebe y retire la aprobación de solicitudes de extracción con approve_pull_request y unapprove_pull_request

• 🔍 Búsqueda avanzada: Busque código y archivos en repositorios con filtrado por proyecto/repositorio usando la herramienta search

• 📄 Operaciones de archivos: Lea el contenido de archivos y explore directorios de repositorios con get_file_content y browse_repository

• 💬 Gestión de comentarios: Extraiga y filtre comentarios de PR con la herramienta get_comments

• 🔍 Descubrimiento de proyectos: Liste todos los proyectos de Bitbucket accesibles con list_projects

• 📁 Exploración de repositorios: Explore repositorios en todos los proyectos con list_repositories

• 🔧 Soporte flexible para proyectos: Haga que el proyecto predeterminado sea opcional: especifíquelo por comando o use BITBUCKET_DEFAULT_PROJECT

• 📖 Documentación mejorada: README mejorado con ejemplos de uso y mejores guías de configuración

Related MCP server: Bitbucket MCP Server

Requisitos

• Node.js >= 16

Instalación

Instalación a través de Smithery

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

Compilación

npm run build

Funciones

El servidor proporciona las siguientes herramientas para una integración completa con Bitbucket Server:

list_projects

Descubra y explore proyectos de Bitbucket: Lista todos los proyectos accesibles con sus detalles. Esencial para el descubrimiento de proyectos y para encontrar las claves de proyecto correctas que se utilizarán en otras operaciones.

Casos de uso:

• Encontrar proyectos disponibles cuando no conoce la clave exacta del proyecto

• Explorar la estructura y los permisos del proyecto

• Descubrir nuevos proyectos a los que tiene acceso

Parámetros:

• limit: Número de proyectos a devolver (predeterminado: 25, máx: 1000)

• start: Índice de inicio para la paginación (predeterminado: 0)

list_repositories

Explore y descubra repositorios: Explore repositorios dentro de proyectos específicos o en todos los proyectos accesibles. Devuelve información completa del repositorio, incluidas las URL de clonación y metadatos.

Casos de uso:

• Encontrar slugs de repositorio para otras operaciones

• Explorar la estructura del código base en todos los proyectos

• Descubrir repositorios a los que tiene acceso

• Explorar los repositorios de un proyecto específico

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• limit: Número de repositorios a devolver (predeterminado: 25, máx: 1000)

• start: Índice de inicio para la paginación (predeterminado: 0)

create_pull_request

Proponga cambios de código para revisión: Crea una nueva solicitud de extracción para enviar cambios de código, solicitar revisiones o fusionar ramas de funciones. Maneja automáticamente las referencias de rama y las asignaciones de revisores.

Casos de uso:

• Enviar el desarrollo de funciones para su revisión

• Proponer correcciones de errores

• Solicitar la integración de código desde ramas de funciones

• Colaborar en cambios de código

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• title (obligatorio): Título de PR claro y descriptivo

• description: Descripción detallada con contexto (admite Markdown)

• sourceBranch (obligatorio): Rama de origen que contiene los cambios

• targetBranch (obligatorio): Rama de destino para la fusión

• reviewers: Matriz de nombres de usuario de los revisores

• sourceProject: Clave del proyecto del repositorio de origen (para PRs entre repositorios desde forks)

• sourceRepository: Slug del repositorio de origen (para PRs entre repositorios desde forks)

• includeDefaultReviewers: Obtener e incluir automáticamente los revisores predeterminados configurados para la rama de destino (predeterminado: true)

update_pull_request

Actualice de forma segura una solicitud de extracción: Modifique el título, la descripción o los revisores de una solicitud de extracción existente sin perder ningún metadato. Utiliza un patrón de lectura-modificación-escritura para preservar todos los campos que no se hayan cambiado explícitamente.

Casos de uso:

• Corregir el título o la descripción de la PR después de la creación

• Añadir o reemplazar revisores sin perder los existentes

• Actualizar los metadatos de la PR sin afectar el estado de aprobación

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción a actualizar

• title: Nuevo título (si se omite, se conserva el título actual)

• description: Nueva descripción (si se omite, se conserva la descripción actual)

• reviewers: Nueva lista de revisores como matriz de nombres de usuario (si se omite, se conservan los revisores actuales)

get_pull_request

Información completa de la PR: Recupera información detallada de la solicitud de extracción, incluido el estado, los revisores, las confirmaciones y todos los metadatos. Esencial para comprender el estado de la PR antes de realizar acciones.

Casos de uso:

• Comprobar el estado de aprobación de la PR

• Revisar los detalles y el progreso de la PR

• Comprender los cambios antes de fusionar

• Supervisar el estado de la PR

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción

merge_pull_request

Integre cambios aprobados: Fusiona una solicitud de extracción aprobada en la rama de destino. Admite diferentes estrategias de fusión según sus preferencias de flujo de trabajo.

Casos de uso:

• Completar el proceso de revisión de código

• Integrar funciones aprobadas

• Aplicar correcciones de errores a las ramas principales

• Publicar cambios de código

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción

• message: Mensaje de confirmación de fusión personalizado

• strategy: Estrategia de fusión:

  • merge-commit (predeterminado): Crea una confirmación de fusión conservando el historial

  • squash: Combina todas las confirmaciones en una sola

  • fast-forward: Mueve el puntero de la rama sin confirmación de fusión

decline_pull_request

Rechace cambios inadecuados: Rechaza una solicitud de extracción que no debe fusionarse, proporcionando comentarios al autor.

Casos de uso:

• Rechazar cambios que no cumplen con los estándares

• Cerrar PRs que entran en conflicto con la dirección del proyecto

• Solicitar una reelaboración significativa

• Evitar la integración de código no deseado

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción

• message: Motivo del rechazo (útil para comentarios al autor)

add_comment

Participe en la revisión de código: Añade comentarios a las solicitudes de extracción para recibir comentarios de revisión, debates y colaboración. Admite conversaciones en hilo.

Casos de uso:

• Proporcionar comentarios de revisión de código

• Hacer preguntas sobre cambios específicos

• Sugerir mejoras

• Participar en debates técnicos

• Documentar decisiones de revisión

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción

• text (obligatorio): Contenido del comentario (admite Markdown)

• parentId: ID del comentario principal para respuestas en hilo

• state: Estado del comentario: OPEN (predeterminado, publicado inmediatamente) o PENDING (borrador, visible solo para usted hasta que se publique la revisión)

get_diff

Analice cambios de código: Recupera las diferencias de código que muestran exactamente qué se añadió, eliminó o modificó en la solicitud de extracción. Admite el truncamiento por archivo para gestionar eficazmente las diferencias grandes.

Casos de uso:

• Revisar cambios de código específicos

• Comprender el alcance de las modificaciones

• Analizar el impacto antes de fusionar

• Inspeccionar detalles de implementación

• Evaluación de la calidad del código

• Manejar archivos grandes sin saturar la salida

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción

• contextLines: Líneas de contexto alrededor de los cambios (predeterminado: 10)

• maxLinesPerFile: Máximo de líneas a mostrar por archivo (opcional, utiliza la variable de entorno BITBUCKET_DIFF_MAX_LINES_PER_FILE si no se especifica, establezca en 0 para sin límite)

Manejo de archivos grandes: Cuando un archivo supera el límite maxLinesPerFile, muestra:

• Encabezados y metadatos del archivo (siempre conservados)

• Primer 60% de las líneas permitidas desde el principio

• Mensaje de truncamiento con estadísticas del archivo

• Último 40% de las líneas permitidas desde el final

• Indicación clara de cómo ver la diferencia completa

get_reviews

Realice un seguimiento del progreso de la revisión: Obtiene el historial de revisiones, el estado de aprobación y los comentarios de los revisores para comprender el estado de la revisión.

Casos de uso:

• Comprobar si la PR está lista para fusionarse

• Ver quién ha revisado los cambios

• Comprender los comentarios de revisión

• Supervisar los requisitos de aprobación

• Realizar un seguimiento del progreso de la revisión

get_activities

Recupere actividades de la solicitud de extracción: Obtiene la línea de tiempo completa de la actividad de una solicitud de extracción, incluidos comentarios, revisiones, confirmaciones y otros eventos.

Casos de uso:

• Leer debates y comentarios

• Revisar la línea de tiempo completa de la PR

• Realizar un seguimiento de las confirmaciones añadidas/eliminadas de la PR

• Ver el historial de aprobación y revisión

• Comprender el ciclo de vida completo de la PR

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción

get_comments

Extraiga solo comentarios de PR: Filtra las actividades de la solicitud de extracción para devolver solo los comentarios, lo que facilita centrarse en el contenido del debate sin revisiones u otras actividades.

Casos de uso:

• Leer hilos de debate de PR

• Extraer comentarios y preguntas

• Centrarse en el contenido del comentario sin ruido

• Analizar el flujo de la conversación

Parámetros:

• project: Clave del proyecto de Bitbucket (opcional, utiliza BITBUCKET_DEFAULT_PROJECT si no se proporciona)

• repository (obligatorio): Slug del repositorio

• prId (obligatorio): ID de la solicitud de extracción

search

Búsqueda avanzada de código y archivos: Busque en repositorios utilizando la API de búsqueda de Bitbucket con soporte para filtrado de proyectos/repositorios y optimización de consultas. Busca tanto el contenido de los archivos como los nombres de los archivos. Nota: La búsqueda solo funciona en la rama predeterminada de los repositorios.

Casos de uso:

• Encontrar patrones de código específicos en todos los proyectos

• Localizar archivos por nombre o contenido

• Buscar dentro de proyectos o repositorios específicos

• Filtrar por extensiones de archivo

Parámetros:

• query (obligatorio): Cadena de consulta de búsqueda

• project: Clave del proyecto de Bitbucket para limitar el alcance de la búsqueda

• repository: Slug del repositorio para la búsqueda específica del repositorio

• type: Optimización de consulta - "file" (envuelve la consulta entre comillas para una coincidencia exacta del nombre de archivo) o "code" (comportamiento de búsqueda predeterminado)

• limit: Número de resultados a devolver (predeterminado: 25, máx: 100)

• start: Índice de inicio para la paginación (predeterminado: 0)

Ejemplos de sintaxis de consulta:

• "README.md" - Encontrar nombre de archivo exacto

• config ext:yml - Encontrar configuración en archivos YAML

• function project:MYPROJECT - Buscar "function" en un proyecto específico

• bug fix repo:PROJ/my-repo - Buscar en un repositorio específico

get_file_content

Lea el contenido de archivos con paginación: Recupere el contenido de archivos específicos de los repositorios con soporte para archivos grandes mediante paginación.

Casos de uso:

• Leer archivos de código fuente

• Ver archivos de configuración

• Extraer contenido de documentación