MCP de Bitbucket

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con las API de Bitbucket Cloud y Server. Este servidor MCP permite que asistentes de IA como Cursor interactúen con sus repositorios de Bitbucket, solicitudes de extracción y otros recursos.

Seguridad ante todo

Este es un paquete seguro y responsable: no se utilizan operaciones DELETE, por lo que no hay riesgo de pérdida de datos. Cada solicitud de extracción se analiza con CodeQL para garantizar la seguridad del código.

Descripción general

Consulta el paquete oficial de npm. Este servidor implementa el estándar del Protocolo de Contexto de Modelo para proporcionar a los asistentes de IA acceso a los datos y operaciones de Bitbucket. Incluye herramientas para:

• Listado y recuperación de repositorios

• Obtener detalles del repositorio

• Obteniendo solicitudes de extracción

• Y más...

Instalación

Uso de NPX (recomendado)

La forma más sencilla de utilizar este servidor MCP es a través de NPX, que le permite ejecutarlo sin instalarlo globalmente:

Instalación manual

Alternativamente, puede instalarlo globalmente o como parte de su proyecto:

Luego ejecútalo con:

Configuración

Variables de entorno

Configure el servidor utilizando las siguientes variables de entorno:

* Se debe proporcionar BITBUCKET_TOKEN o BITBUCKET_USERNAME y BITBUCKET_PASSWORD .

Crear una contraseña para la aplicación Bitbucket

1. Inicie sesión en su cuenta de Bitbucket

2. Vaya a Configuración personal > Contraseñas de aplicaciones

3. Crea una nueva contraseña de aplicación con los siguientes permisos:

   • Repositorios: Leer

   • Solicitudes de extracción: lectura, escritura

4. Copie la contraseña generada y úsela como la variable de entorno BITBUCKET_PASSWORD

Integración con Cursor

Para integrar este servidor MCP con Cursor:

1. Cursor abierto

2. Vaya a Configuración > Extensiones

3. Haga clic en "Protocolo de contexto del modelo"

4. Agregar una nueva configuración de MCP:

5. Guardar la configuración

6. Utilice el comando "/bitbucket" en Cursor para acceder a los repositorios de Bitbucket y a las solicitudes de extracción

Uso de una compilación local con cursor

Si está desarrollando localmente y desea probar sus cambios:

Herramientas disponibles

Este servidor MCP proporciona herramientas para interactuar con repositorios de Bitbucket y solicitudes de extracción. A continuación, se muestra una lista completa de las operaciones disponibles:

Operaciones del repositorio

listRepositories

Enumera los repositorios en un espacio de trabajo.

Parámetros:

• workspace (opcional): nombre del espacio de trabajo de Bitbucket

• limit (opcional): Número máximo de repositorios a devolver

getRepository

Obtiene detalles de un repositorio específico.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

Operaciones de solicitud de extracción

getPullRequests

Obtiene solicitudes de extracción para un repositorio.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• state (opcional): estado de la solicitud de extracción ( OPEN , MERGED , DECLINED , SUPERSEDED )

• limit (opcional): Número máximo de solicitudes de extracción para devolver

createPullRequest

Crea una nueva solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• title : Título de la solicitud de extracción

• description : Descripción de la solicitud de extracción

• sourceBranch : Nombre de la rama de origen

• targetBranch : Nombre de la rama de destino

• reviewers (opcional): Lista de nombres de usuario de los revisores

getPullRequest

Obtiene detalles de una solicitud de extracción específica.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

updatePullRequest

Actualiza una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• Varios parámetros de actualización opcionales (título, descripción, etc.)

getPullRequestActivity

Obtiene el registro de actividad de una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

approvePullRequest

Aprueba una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

unapprovePullRequest

Elimina una aprobación de una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

declinePullRequest

Rechaza una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• message (opcional): Motivo del rechazo

mergePullRequest

Fusiona una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• message (opcional): mensaje de confirmación de fusión

• strategy (opcional): Estrategia de fusión ( merge-commit , squash , fast-forward )

requestChanges

Solicita cambios en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

removeChangeRequest

Elimina una solicitud de cambio de una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

Operaciones de comentarios de solicitudes de extracción

getPullRequestComments

Enumera los comentarios sobre una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

createPullRequestComment

Crea un comentario en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• content : Comentar contenido

• inline (opcional): información de comentarios en línea

getPullRequestComment

Obtiene un comentario específico en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• comment_id : ID del comentario

updatePullRequestComment

Actualiza un comentario en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• comment_id : ID del comentario

• content : Contenido de comentarios actualizado

deletePullRequestComment

Elimina un comentario en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• comment_id : ID del comentario

resolveComment

Resuelve un hilo de comentarios en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• comment_id : ID del comentario

reopenComment

Reabre un hilo de comentarios resuelto en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• comment_id : ID del comentario

Operaciones de diferenciación de solicitudes de extracción

getPullRequestDiff

Obtiene la diferencia para una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

getPullRequestDiffStat

Obtiene las estadísticas de diferencias para una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

getPullRequestPatch

Obtiene el parche para una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

Operaciones de tareas de solicitud de extracción

getPullRequestTasks

Enumera las tareas en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

createPullRequestTask

Crea una tarea en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• content : Contenido de la tarea

• comment (opcional): ID del comentario para asociar con la tarea

• pending (opcional): si la tarea está pendiente

getPullRequestTask

Obtiene una tarea específica en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• task_id : ID de la tarea

updatePullRequestTask

Actualiza una tarea en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• task_id : ID de la tarea

• content (opcional): Contenido de la tarea actualizado

• state (opcional): Estado de la tarea actualizado

deletePullRequestTask

Elimina una tarea en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

• task_id : ID de la tarea

Otras operaciones de solicitud de extracción

getPullRequestCommits

Enumera las confirmaciones en una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

getPullRequestStatuses

Enumera los estados de confirmación para una solicitud de extracción.

Parámetros:

• workspace : nombre del espacio de trabajo de Bitbucket

• repo_slug : Slug del repositorio

• pull_request_id : ID de solicitud de extracción

Desarrollo

Prerrequisitos

• Node.js 18 o superior

• npm o hilo

Configuración

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Campo de golf

• Repositorio de GitHub

• Paquete npm

• Protocolo de contexto modelo

• API REST de Bitbucket: solicitudes de extracción