Bitbucket MCP

Un servidor del Protocolo de Contexto de Modelo (MCP) que integra Cursor IDE con Bitbucket Cloud, permitiéndote obtener información de repositorios y datos de confirmación directamente desde tu espacio de trabajo de Bitbucket.

Características

• Listar repositorios: Obtén todos los repositorios de tu espacio de trabajo de Bitbucket

• Detalles del repositorio: Obtén información detallada sobre repositorios específicos

• Información de confirmaciones: Recupera el historial de confirmaciones y los detalles de la última confirmación

• Recuento de confirmaciones: Obtén el número total de confirmaciones por repositorio

• Datos de la última confirmación: Obtén la fecha, el autor y el mensaje de la confirmación más reciente para cada repositorio

• Espacios de trabajo: Lista todos los espacios de trabajo disponibles.

• Solicitudes de extracción (Pull Requests): Crea, visualiza, lista y actualiza solicitudes de extracción, incluyendo la lectura y adición de comentarios en las PR.

• Proyectos: Visualiza los detalles del proyecto y lista los revisores predeterminados.

• Restricciones de rama: Gestiona las restricciones de rama para proyectos y repositorios.

• Confirmaciones: Recupera confirmaciones individuales y listas de confirmaciones.

Related MCP server: JIRA MCP Server

Requisitos previos

• Node.js 18 o superior

• npm o yarn

• Una cuenta de Bitbucket Cloud

• Contraseña de aplicación de Bitbucket (para autenticación)

Configuración

1. Instalar dependencias

npm install

2. Construir el proyecto

npm run build

3. Crear token de API de Atlassian*

• si ya tienes un token para Jira o Confluence, puedes reutilizarlo *

1. Ve a la configuración de tu cuenta de Bitbucket

2. Navega a "Contraseñas de aplicación" bajo "Gestión de acceso"

3. En lugar de hacer clic en "Crear contraseña de aplicación" (obsoleto), navega a "Ir a tokens de API"

4. Crea un token de API

5. Dale un nombre descriptivo (p. ej., "Integración MCP de Cursor")

6. Selecciona la fecha de caducidad

7. Copia el token generado

4. Configurar variables de entorno

Crea un archivo .env en la raíz del proyecto:

BITBUCKET_USERNAME=your_bitbucket_email_address
BITBUCKET_APP_PASSWORD=your_api_token
BITBUCKET_WORKSPACE=your_workspace_name

Nota: El nombre del espacio de trabajo suele ser tu nombre de usuario o el nombre de la organización. Puedes encontrarlo en tus URLs de Bitbucket (p. ej., https://bitbucket.org/workspace_name/).

5. Añadir a la configuración MCP de Cursor

Añade la siguiente configuración a tus ajustes de MCP en Cursor:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["@korfu/bitbucket-mcp"],
      "env": {
        "BITBUCKET_USERNAME": "your_bitbucket_email_address",
        "BITBUCKET_APP_PASSWORD": "your_api_token",
        "BITBUCKET_WORKSPACE": "your_workspace_name"
      }
    }
  }
}

6. Reiniciar Cursor

Después de añadir la configuración, reinicia Cursor IDE para cargar el servidor MCP.

Uso

Una vez configurado, puedes usar las siguientes herramientas en Cursor:

Espacios de trabajo

• bitbucket_list_workspaces

Repositorios

• bitbucket_list_repositories

• bitbucket_get_repository_details

Confirmaciones

• bitbucket_list_commits

• bitbucket_get_commit

Solicitudes de extracción (Pull Requests)

• bitbucket_list_pull_requests

• bitbucket_get_pull_request

• bitbucket_create_pull_request

• bitbucket_update_pull_request

• bitbucket_list_pull_request_comments

• bitbucket_get_pull_request_comment

• bitbucket_add_pull_request_comment

Proyectos

• bitbucket_get_project

• bitbucket_list_default_reviewers

Restricciones de rama

• bitbucket_list_branch_restrictions

• bitbucket_get_branch_restriction

• bitbucket_update_repository_branching_model_settings

• bitbucket_update_project_branching_model_settings

Herramientas disponibles

Espacios de trabajo

• list_workspaces: Lista todos los espacios de trabajo accesibles por el usuario actual.

Repositorios

• list_repositories: Lista todos los repositorios en el espacio de trabajo de Bitbucket configurado.

• get_repository_details: Obtiene información detallada sobre un repositorio específico, incluyendo información de la última confirmación.

Confirmaciones

• list_commits: Obtiene información de confirmaciones para un repositorio específico.

• get_commit: Obtiene una única confirmación por su hash.

Solicitudes de extracción (Pull Requests)

• list_pull_requests: Lista todas las solicitudes de extracción en un repositorio.

• get_pull_request: Obtiene una única solicitud de extracción por su ID.

• create_pull_request: Crea una nueva solicitud de extracción. //Versión beta - no probada

• update_pull_request: Actualiza una solicitud de extracción existente. //Versión beta - no probada

• list_pull_request_comments: Lista todos los comentarios en una solicitud de extracción (globales, en línea y respuestas) con soporte de paginación.

• get_pull_request_comment: Obtiene un único comentario en una solicitud de extracción por su ID, incluyendo contexto de archivo/línea en línea.

• add_pull_request_comment: Añade un comentario a una solicitud de extracción. Soporta comentarios generales, comentarios en línea en archivos/líneas específicos y respuestas en hilos.

Proyectos

• get_project: Obtiene un único proyecto por su clave.

• list_default_reviewers: Lista los revisores predeterminados para un proyecto.

Restricciones de rama

• list_branch_restrictions: Lista todas las restricciones de rama para un repositorio.

• get_branch_restriction: Obtiene una única restricción de rama por su ID.

• update_repository_branching_model_settings: Actualiza la configuración del modelo de ramificación para un repositorio. //Versión beta - no probada

• update_project_branching_model_settings: Actualiza la configuración del modelo de ramificación para un proyecto. //Versión beta - no probada

Desarrollo

Ejecución en modo desarrollo

npm run dev

Construcción

npm run build

Estructura del proyecto

BitbucketMCP/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── .gitignore           # Git ignore rules
└── README.md            # This file

Solución de problemas

Problemas de autenticación

• Verifica que tu nombre de usuario de Bitbucket y la contraseña de aplicación sean correctos

• Asegúrate de que la contraseña de aplicación tenga los permisos correctos (Repositorios: Lectura)

• Comprueba que el nombre del espacio de trabajo sea correcto

Problemas de conexión

• Verifica tu conexión a internet

• Comprueba si la API de Bitbucket es accesible desde tu red

• Asegúrate de que el servidor MCP esté ejecutándose (revisa los registros MCP de Cursor)

Repositorio no encontrado

• Verifica que el nombre del repositorio sea correcto (usa el slug del repositorio, no el nombre mostrado)

• Asegúrate de tener acceso al repositorio

• Comprueba que el repositorio exista en el espacio de trabajo especificado

El servidor MCP no carga

• Verifica que la ruta a dist/index.js sea correcta en tu configuración de Cursor

• Asegúrate de que Node.js esté instalado y accesible desde la línea de comandos

• Revisa los registros del servidor MCP de Cursor para ver mensajes de error

Notas de seguridad

• Mantén tu contraseña de aplicación de Bitbucket segura y nunca la subas al control de versiones

• Usa variables de entorno o gestión de configuración segura para las credenciales

• La contraseña de aplicación solo debe tener los permisos mínimos requeridos

• Considera rotar tu contraseña de aplicación regularmente

Contribución

1. Haz un fork del repositorio

2. Crea una rama de características

3. Realiza tus cambios

4. Añade pruebas si corresponde

5. Envía una solicitud de extracción

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles