Skip to main content
Glama
Sign In
enesjakozh

Bitbucket MCP

by MatanYemini
npmGitHub
JavaScript
MIT License
820
4
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Enables interaction with Bitbucket Cloud and Server APIs, providing tools for listing and retrieving repositories, managing pull requests, and working with repository content.

  • Supports working with Git repositories stored in Bitbucket, allowing access to repository content and version control operations.

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:

# 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:

VariableDescripciónRequerido
BITBUCKET_URLURL base de Bitbucket (por ejemplo, " https://bitbucket.org/your-workspace ")Sí
BITBUCKET_USERNAMESu nombre de usuario de BitbucketSí*
BITBUCKET_PASSWORDTu contraseña de la aplicación BitbucketSí*
BITBUCKET_TOKENSu token de acceso de Bitbucket (alternativa al nombre de usuario/contraseña)No
BITBUCKET_WORKSPACEEspacio de trabajo predeterminado que se utilizará cuando no se especifiqueNo

* 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"] }
  1. Guardar la configuración
  2. 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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA interactuar con repositorios de Bitbucket, solicitudes de extracción y otros recursos a través de las API de Bitbucket Cloud y Server.

  1. Safety First
    1. Overview
      1. Installation
        1. Using NPX (Recommended)
        2. Manual Installation
      2. Configuration
        1. Environment Variables
        2. Creating a Bitbucket App Password
      3. Integration with Cursor
        1. Using a Local Build with Cursor
      4. Available Tools
        1. Repository Operations
        2. Pull Request Operations
        3. Pull Request Comment Operations
        4. Pull Request Diff Operations
        5. Pull Request Task Operations
        6. Other Pull Request Operations
      5. Development
        1. Prerequisites
        2. Setup
      6. License
        1. Links

          Related MCP Servers

          • GitHub MCP Server

            PoliTwit1984
            A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.
            Last updated -
            1
            JavaScript

          • GitHub MCP Server

            Jehan26
            -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.
            Last updated -
            129
            Python

          • GitHub MCP Server

            renantrendt
            -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables AI assistants to perform GitHub operations including repository management, file operations, issue tracking, and pull request creation.
            Last updated -
            1
            TypeScript

          • MCP Toolkit

            zxfgds
            -
            security
            F
            license
            -
            quality
            A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
            Last updated -
            16
            TypeScript

          View all related MCP servers

          ID: n7bfg1br32