Servidor MCP de Bitbucket

Bitbucket MCP es un servidor sin estado de alto rendimiento que lleva todo el potencial de la API de Bitbucket Cloud a sus automatizaciones, pipelines de CI/CD, bots e integraciones basadas en Rust. Construido en Rust para mayor velocidad y fiabilidad, Bitbucket MCP facilita el acceso y la gestión segura de repositorios, solicitudes de extracción, incidencias y más de Bitbucket, ya sea que esté creando herramientas para desarrolladores, automatización de flujos de trabajo o soluciones DevOps.

¿Por qué Bitbucket MCP?

• Integración fluida con la API de Bitbucket: Acceda a todas las funciones principales de Bitbucket Cloud (repositorios, solicitudes de extracción, incidencias, ramas, pipelines, despliegues y más) utilizando una base de código moderna en Rust.

• Perfecto para automatización y bots: Exponga Bitbucket como herramientas del Protocolo de Contexto de Modelo (MCP), ideal para bots, CI/CD y automatización de flujos de trabajo.

• Seguro por defecto: Utiliza solo rustls para TLS (sin los problemas de OpenSSL) y admite autenticación mediante token de API de Bitbucket.

• Listo para Docker: Despliéguelo en cualquier lugar con nuestras imágenes de Docker preconstruidas en GHCR, o constrúyalo localmente en minutos.

• Probado en batalla: Un conjunto completo de pruebas cubre todos los métodos de la API pública, garantizando la fiabilidad de sus integraciones.

Related MCP server: Bitbucket MCP Server

Inicio rápido: Automatización de la API de Bitbucket en Rust

1. Utilice la imagen de Docker preconstruida de GHCR

docker run -e BITBUCKET_API_USERNAME=<your_atlassian_email> -e BITBUCKET_API_TOKEN=<your_api_token> -p 8080:8080 ghcr.io/ibrahimogod/bitbucket-mcp:latest

• Encuentre todas las etiquetas/versiones en: GitHub Releases

• Consulte el paquete GHCR

2. Construya y ejecute localmente (Rust)

git clone https://github.com/Ibrahimogod/bitbucket-mcp.git
cd bitbucket-mcp
cargo build --release
$env:BITBUCKET_API_USERNAME="<your_atlassian_email>"
$env:BITBUCKET_API_TOKEN="<your_api_token>"
cargo run --release --bin bitbucket_stdio

Operaciones de Bitbucket compatibles (vía MCP)

• Listar y gestionar repositorios, espacios de trabajo, solicitudes de extracción, incidencias, ramas, etiquetas y confirmaciones (commits)

• Obtener detalles de repositorios, espacios de trabajo y usuarios

• Automatizar flujos de trabajo de solicitudes de extracción: crear, actualizar, aprobar, rechazar, fusionar, comentar y gestionar tareas

• Integrarse con pipelines, despliegues, descargas, webhooks, fragmentos (snippets) y proyectos de Bitbucket

• Consulte src/common/bitbucket.rs para ver la API completa

Autenticación de Bitbucket

• Cree un token de API de Bitbucket con los alcances (scopes) adecuados (p. ej., repository:read, pullrequest:read).

• Establezca BITBUCKET_API_USERNAME con su correo electrónico de Atlassian.

• Establezca BITBUCKET_API_TOKEN con su token de API.

Estructura del proyecto

• src/common/bitbucket.rs — Lógica de integración de la API de Bitbucket

• src/bitbucket_stdio.rs — Punto de entrada del servidor

• Cargo.toml — Configuración de dependencias (usa solo rustls)

• Dockerfile — Construcción multietapa, sin OpenSSL

• tests/bitbucket.rs — Conjunto completo de pruebas para todos los métodos de la API pública

Licencia

MIT

Bitbucket MCP es la mejor manera de automatizar Bitbucket Cloud con Rust, bots o CI/CD. ¡Marque el repositorio con una estrella y pruébelo hoy mismo!

Ejemplo: Configuración de MCP en VS Code para integración con Docker

Puede configurar la extensión MCP de VS Code para iniciar el servidor Bitbucket MCP automáticamente usando Docker. Añada lo siguiente a su .vscode/settings.json (o a su archivo de configuración global de MCP):

{
  "mcp": {
    "servers": {
      "bitbucket-mcp-docker": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "-e", "BITBUCKET_API_USERNAME",
          "-e", "BITBUCKET_API_TOKEN",
          "-e", "RUST_BACKTRACE",
          "ghcr.io/ibrahimogod/bitbucket-mcp:latest"
        ],
        "env": {
          "BITBUCKET_API_USERNAME": "<your_atlassian_email>",
          "BITBUCKET_API_TOKEN": "<your_api_token>",
          "RUST_BACKTRACE": "1"
        }
      }
    }
  }
}

Reemplace <your_atlassian_email> y <your_api_token> con sus credenciales de Bitbucket. También puede especificar una etiqueta de imagen particular en lugar de latest si es necesario.

Esta configuración permite que la extensión MCP inicie el servidor Bitbucket MCP en Docker automáticamente cuando utilice herramientas de Bitbucket en VS Code.

Ejemplo: Configuración de MCP en Cursor para integración con Docker

Puede configurar Cursor para iniciar el servidor Bitbucket MCP automáticamente usando Docker. Añada lo siguiente a su .cursor/mcp.json (para el proyecto) o ~/.cursor/mcp.json (para uso global):

{
  "mcpServers": {
    "bitbucket-mcp-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e", "BITBUCKET_API_USERNAME",
        "-e", "BITBUCKET_API_TOKEN",
        "-e", "RUST_BACKTRACE",
        "ghcr.io/ibrahimogod/bitbucket-mcp:latest"
      ],
      "env": {
        "BITBUCKET_API_USERNAME": "<your_atlassian_email>",
        "BITBUCKET_API_TOKEN": "<your_api_token>",
        "RUST_BACKTRACE": "1"
      }
    }
  }
}

Reemplace <your_atlassian_email> y <your_api_token> con sus credenciales de Bitbucket. También puede especificar una etiqueta de imagen particular en lugar de latest si es necesario.

Esta configuración permite que Cursor inicie el servidor Bitbucket MCP en Docker automáticamente cuando utilice herramientas de Bitbucket.