Bitbucket Server MCP

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.

Integrations

  • Provides tools for managing Bitbucket Server pull requests, including creating, retrieving, merging, and declining PRs, adding comments, retrieving diffs, and managing reviews.

Servidor Bitbucket MCP

Servidor MCP (Protocolo de Contexto de Modelo) para la gestión de solicitudes de extracción de Bitbucket Server. Este servidor proporciona herramientas y recursos para interactuar con la API de Bitbucket Server mediante el protocolo MCP.

Requisitos

  • Node.js >= 16

Instalación

Instalación mediante herrería

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

Construir

npm run build

Características

El servidor proporciona las siguientes herramientas para la integración de Bitbucket Server:

create_pull_request

Crea una nueva solicitud de extracción.

Parámetros:

  • project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
  • repository (obligatorio): slug del repositorio
  • title (obligatorio): Título de PR
  • description : Descripción de relaciones públicas
  • sourceBranch (obligatorio): Nombre de la rama de origen
  • targetBranch (obligatorio): nombre de la rama de destino
  • reviewers : Matriz de nombres de usuario de revisores

get_pull_request

Recupera información detallada sobre una solicitud de extracción específica.

Parámetros:

  • project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
  • repository (obligatorio): slug del repositorio
  • prId (obligatorio): ID de la solicitud de extracción

merge_pull_request

Fusiona una solicitud de extracción.

Parámetros:

  • project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
  • repository (obligatorio): slug del repositorio
  • prId (obligatorio): ID de la solicitud de extracción
  • message : Mensaje de confirmación de fusión
  • strategy : Una de:
    • merge-commit (predeterminado)
    • squash
    • fast-forward

decline_pull_request

Rechaza una solicitud de extracción.

Parámetros:

  • project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
  • repository (obligatorio): slug del repositorio
  • prId (obligatorio): ID de la solicitud de extracción
  • message : Motivo del rechazo

add_comment

Agrega un comentario a una solicitud de extracción.

Parámetros:

  • project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
  • repository (obligatorio): slug del repositorio
  • prId (obligatorio): ID de la solicitud de extracción
  • text (obligatorio): Texto del comentario
  • parentId : ID del comentario principal para las respuestas

get_diff

Recupera la diferencia para una solicitud de extracción.

Parámetros:

  • project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
  • repository (obligatorio): slug del repositorio
  • prId (obligatorio): ID de la solicitud de extracción
  • contextLines : Número de líneas de contexto (predeterminado: 10)

get_reviews

Obtiene el historial de revisión de una solicitud de extracción, incluidas las aprobaciones y revisiones.

Parámetros:

  • project : clave de proyecto de Bitbucket (el valor predeterminado es BITBUCKET_DEFAULT_PROJECT si está configurado)
  • repository (obligatorio): slug del repositorio
  • prId (obligatorio): ID de la solicitud de extracción

Dependencias

  • @modelcontextprotocol/sdk - SDK para la implementación del protocolo MCP
  • axios - Cliente HTTP para solicitudes API
  • winston - Marco de registro

Configuración

El servidor requiere configuración en el archivo de configuración MCP de VSCode. A continuación, se muestra un ejemplo de configuración:

{ "mcpServers": { "bitbucket": { "command": "node", "args": ["/path/to/bitbucket-server/build/index.js"], "env": { "BITBUCKET_URL": "https://your-bitbucket-server.com", // Authentication (choose one): // Option 1: Personal Access Token "BITBUCKET_TOKEN": "your-access-token", // Option 2: Username/Password "BITBUCKET_USERNAME": "your-username", "BITBUCKET_PASSWORD": "your-password", // Optional: Default project "BITBUCKET_DEFAULT_PROJECT": "your-default-project" } } } }

Variables de entorno

  • BITBUCKET_URL (obligatorio): URL base de su instancia de Bitbucket Server
  • Autenticación (se requiere uno de los siguientes):
    • BITBUCKET_TOKEN : Token de acceso personal
    • BITBUCKET_USERNAME y BITBUCKET_PASSWORD : Credenciales de autenticación básicas
  • BITBUCKET_DEFAULT_PROJECT : Clave de proyecto predeterminada que se utilizará cuando no se especifique en las llamadas de herramientas

Explotación florestal

El servidor registra todas las operaciones en bitbucket.log utilizando Winston para fines de depuración y monitoreo.

You must be authenticated.

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

Facilita la interacción con Bitbucket Server para la gestión de solicitudes de extracción mediante el protocolo MCP, admitiendo operaciones como crear, fusionar, comentar y revisar solicitudes de extracción.

  1. Requirements
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Build
      1. Features
        1. create_pull_request
        2. get_pull_request
        3. merge_pull_request
        4. decline_pull_request
        5. add_comment
        6. get_diff
        7. get_reviews
      2. Dependencies
        1. Configuration
          1. Environment Variables
        2. Logging
          ID: jskr5c1zq3