Bitbucket MCP Server

🌬️ bitbucket-mcp-server

Implementación simple de MCP para (principalmente) pull requests en Bitbucket.

Proporciona contexto de tus PRs a tu LLM favorito y ¡deja que las revise por ti!

Escrito en Bun y Civet usando Cursor como asistente.

Lee la documentación aquí.

🚧 Este repositorio es un ejercicio de aprendizaje de MCP y todavía está en progreso.

La API aquí carece de muchas funciones por ahora. Es posible que se agreguen más funciones en un futuro cercano.

Además, la documentación fue escrita por el propio Cursor. No esperes que sea perfecta. 🚧

Instalación

Primero clona este repositorio en algún lugar que desees.

Luego hay 2 formas de ejecutarlo localmente:

• Si quieres descargar y usar la versión de lanzamiento, puedes ejecutarlo mediante el binario disponible en los Releases de este repositorio;
• De lo contrario, tendrás que compilarlo desde cero o instalar Bun y ejecutar el archivo index.civet directamente.

Lanzamiento

Para ejecutar desde los binarios precompilados, ve a la página de Releases y obtén la última versión desde allí.

Extrae el binario en algún lugar que desees.

Luego, agrega esto a la configuración de tus servidores MCP:

{
  "mcpServers": {
    "Bitbucket": {
      // Or just \`bitbucket-mcp-server\` if you made it
      // available as a system/user-wide binary
      "command": "/path/to/bitbucket-mcp-server",
      "args": ["username:password"]
    }
  }
}

Esto es suficiente para poner en marcha el servidor.

Bun/Compilación

Si quieres ejecutar con Bun (o compilar con él), primero necesitarás instalar bun ejecutando:

curl -fsSL https://bun.sh/install | bash

Luego, desde el directorio del proyecto, instala todas las dependencias con:

bun i

Ejecutar con Bun

Para ejecutar con bun directamente, agrega esta entrada a la configuración de tus servidores MCP:

{
  "mcpServers": {
    "Bitbucket": {
      "command": "bun",
      "args": [
        "run",
        "/path/to/repository/src/index.civet",
        "username:password"
      ]
    }
  }
}

Compilación

Ejecuta el comando de compilación desde el directorio raíz del proyecto:

bun run build

Esto generará un binario en la carpeta dist/ para la arquitectura que estés usando.

Luego sigue los mismos pasos de la opción Lanzamiento para agregar el servidor MCP a tu configuración.

Desarrollo

Asegúrate de tener instalados tanto el runtime de Bun como la extensión de VSCode/Cursor de Civet.

Luego, después de clonar el repositorio, instala sus dependencias:

cd /path/to/repository
bun i

La mejor manera de visualizar todo funcionando es ejecutando:

bun inspect username:password

Esto abrirá el Inspector de MCP con una interfaz gráfica para jugar y explorar las herramientas de MCP.

Limitación de las herramientas MCP

MCP tiene una limitación de 40 herramientas que se enviarán al agente.

Actualmente bitbucket-mcp-server proporciona 24 herramientas en total. Considera deshabilitar las que no uses con frecuencia para ahorrar algunos espacios.

Por hacer

• Quizás implementar OAuth

---

Este proyecto fue creado usando bun init en bun v1.2.17. Bun es un runtime de JavaScript rápido y todo en uno.