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.

Related MCP server: Bitbucket MCP Server

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:

# Run with environment variables
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx -y bitbucket-mcp@latest

Instalación manual

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

# Install globally
npm install -g bitbucket-mcp

# Or install in your project
npm install bitbucket-mcp

Luego ejecútalo con:

# If installed globally
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
bitbucket-mcp

# If installed in your project
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx bitbucket-mcp

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:

"bitbucket": {
  "command": "npx",
  "env": {
    "BITBUCKET_URL": "https://bitbucket.org/your-workspace",
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_PASSWORD": "your-app-password"
  },
  "args": ["-y", "bitbucket-mcp@latest"]
}

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:

"bitbucket-local": {
  "command": "node",
  "env": {
    "BITBUCKET_URL": "https://bitbucket.org/your-workspace",
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_PASSWORD": "your-app-password"
  },
  "args": ["/path/to/your/local/bitbucket-mcp/dist/index.js"]
}

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

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

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

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