Skip to main content
Glama
Sign In
enesjakozh

Atlassian Bitbucket MCP Server

by aashari
Verified
npmGitHub
TypeScript
317
8
  • Apple
  • Linux
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 authentication and integration with Atlassian services, specifically focused on Bitbucket functionality using Atlassian API tokens.

  • Allows AI assistants to interact with Bitbucket repositories, including listing repositories, accessing pull requests, viewing commit information, and exploring workspaces.

Servidor MCP de Atlassian Bitbucket

Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) que actúa como puente entre los asistentes de IA (como Claude de Anthropic, Cursor AI u otros clientes compatibles con MCP) y su instancia de Bitbucket de Atlassian. Permite que la IA acceda e interactúe de forma segura con sus repositorios, solicitudes de extracción y espacios de trabajo en tiempo real.

Descripción general

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los sistemas de IA conectarse de forma segura y contextual con herramientas y fuentes de datos externas.

Este servidor implementa MCP específicamente para Bitbucket Cloud, conectando sus datos de Bitbucket con asistentes de IA.

¿Por qué utilizar este servidor?

  • Filosofía de entrada mínima, salida máxima : Identificadores simples como workspaceSlug y repoSlug son todo lo que necesita. Cada herramienta devuelve información completa sin necesidad de indicadores adicionales.
  • Visualización de código enriquecido : obtenga información detallada sobre los repositorios y los cambios de código con estadísticas de archivos, vistas de diferencias y contexto inteligente en torno a las modificaciones del código.
  • Autenticación local segura : Las credenciales nunca se almacenan en el servidor. El servidor se ejecuta localmente, por lo que sus tokens nunca salen de su equipo y solo puede solicitar los permisos que necesita.
  • Respuestas intuitivas de Markdown : todas las respuestas utilizan Markdown bien estructurado para facilitar la lectura con formato consistente y enlaces de navegación.
  • Integración completa con Bitbucket : acceda a espacios de trabajo, repositorios, solicitudes de extracción, comentarios, búsqueda de código y más a través de una interfaz unificada.

Empezando

Prerrequisitos

  • Node.js (>=18.x): Descargar
  • Cuenta en la nube de Bitbucket

Paso 1: Autenticar

Elija uno de los siguientes métodos de autenticación:

Opción A: Contraseña de la aplicación Bitbucket (recomendada)

Genera una desde las contraseñas de la aplicación Bitbucket . Permisos mínimos:

  • Espacios de trabajo: Leer
  • Repositorios: Leer
  • Solicitudes de extracción: leer

Opción B: Token de API de Atlassian

Genere uno a partir de tokens API de Atlassian .

Paso 2: Configurar credenciales

Método A: Archivo de configuración MCP (recomendado)

Crear o editar ~/.mcp/configs.json :

Usando la contraseña de la aplicación Bitbucket:

{ "@aashari/mcp-server-atlassian-bitbucket": { "environments": { "ATLASSIAN_BITBUCKET_USERNAME": "<your_username>", "ATLASSIAN_BITBUCKET_APP_PASSWORD": "<your_app_password>" } } }

Uso del token API de Atlassian:

{ "@aashari/mcp-server-atlassian-bitbucket": { "environments": { "ATLASSIAN_SITE_NAME": "bitbucket", "ATLASSIAN_USER_EMAIL": "<your_email>", "ATLASSIAN_API_TOKEN": "<your_api_token>" } } }

Método B: Variables de entorno

Pase las credenciales directamente al ejecutar el servidor:

ATLASSIAN_BITBUCKET_USERNAME="<your_username>" \ ATLASSIAN_BITBUCKET_APP_PASSWORD="<your_app_password>" \ npx -y @aashari/mcp-server-atlassian-bitbucket

Paso 3: Conecta tu asistente de IA

Configure su cliente compatible con MCP para iniciar este servidor.

Claude / Configuración del cursor:

{ "mcpServers": { "aashari/mcp-server-atlassian-bitbucket": { "command": "npx", "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"] } } }

Esta configuración inicia el servidor automáticamente en tiempo de ejecución.

Herramientas

Esta sección describe las herramientas MCP disponibles al usar este servidor con un asistente de IA. Tenga en cuenta que las herramientas MCP usan snake_case para los nombres de las herramientas y camelCase para los parámetros.

list_workspaces

Enumere los espacios de trabajo de Bitbucket disponibles.

{}

o:

{ "query": "devteam" }

"Muéstrame todos mis espacios de trabajo de Bitbucket".

get_workspace

Obtenga detalles completos de un espacio de trabajo específico.

{ "workspaceSlug": "acme-corp" }

"Cuéntame más sobre el espacio de trabajo 'acme-corp'".

list_repositories

Enumerar repositorios en un espacio de trabajo.

{ "workspaceSlug": "acme-corp" }

o:

{ "workspaceSlug": "acme-corp", "query": "api" }

"Enumerar repositorios en 'acme-corp'."

get_repository

Obtenga detalles de un repositorio específico.

{ "workspaceSlug": "acme-corp", "repoSlug": "backend-api" }

"Muéstrame el repositorio 'backend-api' en 'acme-corp'."

Buscar contenido de Bitbucket.

Repositorios:

{ "workspaceSlug": "acme-corp", "query": "api", "scope": "repositories" }

Solicitudes de extracción:

{ "workspaceSlug": "acme-corp", "repoSlug": "backend-api", "query": "fix", "scope": "pullrequests" }

Confirmaciones:

{ "workspaceSlug": "acme-corp", "repoSlug": "backend-api", "query": "update", "scope": "commits" }

Código:

{ "workspaceSlug": "acme-corp", "query": "function getUser", "scope": "code" }

"Busque 'función getUser' en el espacio de trabajo 'acme-corp'".

list_pull_requests

Enumerar solicitudes de extracción en un repositorio.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "state": "OPEN" }

"Mostrar solicitudes de solicitud abiertas en 'frontend-app'."

get_pull_request

Obtenga detalles completos de una solicitud de extracción, incluidas las diferencias de código y los cambios de archivos.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

"Obtenga el PR n.° 42 de 'frontend-app' con todos los cambios de código".

list_pr_comments

Enumere los comentarios sobre una solicitud de extracción específica.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

"Muéstrame todos los comentarios sobre PR #42."

add_pr_comment

Agregar un comentario a una solicitud de extracción.

General:

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42", "content": "Looks good." }

En línea:

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42", "content": "Consider refactoring.", "inline": { "path": "src/utils.js", "line": 42 } }

"Agregar un comentario al PR #42 en la línea 42."

pull_requests_create

Crear una nueva solicitud de extracción.

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "title": "Add login screen", "sourceBranch": "feature/login" }

"Crear una PR desde 'función/inicio de sesión' a 'principal'."

Interfaz de línea de comandos (CLI)

La CLI utiliza kebab-case para comandos (por ejemplo, list-workspaces ) y opciones (por ejemplo, --workspace-slug ).

Uso rápido con npx

npx -y @aashari/mcp-server-atlassian-bitbucket list-workspaces npx -y @aashari/mcp-server-atlassian-bitbucket get-repository \ --workspace-slug acme-corp \ --repo-slug backend-api

Instalar globalmente

npm install -g @aashari/mcp-server-atlassian-bitbucket

Luego ejecuta directamente:

mcp-atlassian-bitbucket list-workspaces

Descubra más opciones de CLI

Utilice --help para ver las banderas y el uso de todos los comandos disponibles:

mcp-atlassian-bitbucket --help

O obtenga ayuda detallada para un comando específico:

mcp-atlassian-bitbucket get-repository --help mcp-atlassian-bitbucket list-pull-requests --help mcp-atlassian-bitbucket search --help

Licencia

Licencia ISC

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Tools

Una herramienta de integración que permite a los asistentes de IA como Claude acceder e interactuar directamente con repositorios de Bitbucket, solicitudes de extracción y código sin necesidad de operaciones de copiar y pegar.

  1. Overview
    1. What is MCP?
    2. Why Use This Server?
  2. Getting Started
    1. Prerequisites
    2. Step 1: Authenticate
    3. Step 2: Configure Credentials
    4. Step 3: Connect Your AI Assistant
  3. Tools
    1. list_workspaces
    2. get_workspace
    3. list_repositories
    4. get_repository
    5. search
    6. list_pull_requests
    7. get_pull_request
    8. list_pr_comments
    9. add_pr_comment
    10. pull_requests_create
  4. Command-Line Interface (CLI)
    1. Quick Use with npx
    2. Install Globally
    3. Discover More CLI Options
  5. License

    Appeared in Searches

    ID: d3mfwp6ce5