MCP Bitbucket Python 🦊

Implementación en Python de un servidor MCP para la integración con Bitbucket. MCP (Protocolo de Contexto de Modelo) permite el acceso seguro y local a herramientas para aplicaciones de IA. El servidor se ejecuta localmente en la misma máquina que la aplicación de IA.

Instalación

# Install the server locally
git clone https://github.com/kallows/mcp-bitbucket.git

Related MCP server: bitbucket-mcp-server

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas de integración de Bitbucket:

• bb_create_repository : Crea un nuevo repositorio de Bitbucket

  • Obligatorio: nombre (nombre del repositorio)

  • Opcional: descripción, espacio de trabajo (predeterminado: kallows), clave_de_proyecto, is_private (predeterminado: verdadero), has_issues (predeterminado: verdadero)

• bb_create_branch : Crea una nueva rama en un repositorio

  • Obligatorio: repo_slug, rama (nombre de la nueva rama)

  • Opcional: espacio de trabajo (predeterminado en kallows), punto de inicio (predeterminado en principal)

• bb_delete_repository : eliminar un repositorio de Bitbucket

  • Requerido: repo_slug

  • Opcional: espacio de trabajo (predeterminado en kallows)

• bb_read_file : Leer un archivo de un repositorio

  • Obligatorio: repo_slug, path (ruta del archivo en el repositorio)

  • Opcional: espacio de trabajo (predeterminado en kallows), rama (predeterminado en principal/master)

• bb_write_file : Crea o actualiza un archivo en un repositorio

  • Obligatorio: repo_slug, ruta, contenido

  • Opcional: espacio de trabajo (predeterminado: kallows), rama (predeterminado: principal), mensaje (mensaje de confirmación)

• bb_create_issue : Crea un problema en un repositorio

  • Obligatorio: repo_slug, título, contenido

  • Opcional: espacio de trabajo (predeterminado: kallows), tipo (error/mejora/propuesta/tarea), prioridad (trivial/menor/mayor/crítico/bloqueador)

• bb_delete_issue : Eliminar un problema de un repositorio

  • Obligatorio: repo_slug, issue_id

  • Opcional: espacio de trabajo (predeterminado en kallows)

• bb_search_repositories : busca repositorios de Bitbucket mediante sintaxis de consulta

  • Obligatorio: consulta (por ejemplo, 'nombre ~ "prueba"' o 'proyecto.key = "PROJ"')

  • Opcional: espacio de trabajo (predeterminado: kallows), página (predeterminado: 1), longitud de página (predeterminado: 10, máximo: 100)

• bb_delete_file : Eliminar un archivo de un repositorio

  • Obligatorio: repo_slug, ruta

  • Opcional: espacio de trabajo (predeterminado en kallows), rama (predeterminado en principal), mensaje (mensaje de confirmación)

• bb_create_pull_request : Crea una solicitud de extracción

  • Obligatorio: repo_slug, título, rama_fuente

  • Opcional: espacio de trabajo (predeterminado: kallows), rama_de_destino (predeterminado: principal), descripción, rama_de_origen_cerrada (predeterminado: verdadero)

Configuración del entorno

El servidor requiere que las credenciales de Bitbucket se configuren como variables de entorno:

export BITBUCKET_USERNAME="your-username"
export BITBUCKET_APP_PASSWORD="your-app-password"

Estructura del proyecto

mcp-bitbucket/
├── README.md
├── pyproject.toml
├── src/
│   └── bitbucket_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_bb_api.py
    └── test_bb_integration.py