Bitbucket MCP Server

🌬️ bitbucket-mcp-server

Implementação simples de MCP para (principalmente) pull requests no Bitbucket.

Forneça contexto dos seus PRs para o seu LLM favorito e deixe que ele os revise para você!

Escrito em Bun e Civet usando Cursor como assistente.

Leia a documentação aqui.

🚧 Este repositório é um exercício de aprendizado de MCP e ainda está em andamento.

A API aqui carece de muitos recursos até o momento. Mais recursos podem ser adicionados em um futuro próximo.

Além disso, a documentação foi escrita pelo próprio Cursor. Não espere que seja perfeita. 🚧

Instalação

Primeiro, clone este repositório em algum lugar de sua preferência.

Depois, há 2 maneiras de executá-lo localmente:

• Se você quiser baixar e usar a versão de lançamento, pode executar via binário disponível neste repositório Releases;
• Caso contrário, você terá que compilar do zero ou instalar Bun e executar o arquivo index.civet diretamente.

Lançamento

Para executar a partir dos binários pré-compilados, vá para a página Releases e obtenha a versão mais recente de lá.

Extraia o binário em algum lugar de sua preferência.

Depois, adicione isto às configurações dos seus 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"]
    }
  }
}

Isso é suficiente para iniciar o servidor.

Bun/Build

Se você quiser executar com Bun (ou compilar com ele), primeiro precisará instalar bun executando:

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

Depois, a partir do diretório do projeto, instale todas as dependências com:

bun i

Executando com Bun

Para executar com bun diretamente, adicione esta entrada às configurações dos seus servidores MCP:

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

Compilando

Execute o comando de build a partir do diretório raiz do projeto:

bun run build

Isso gerará um binário na pasta dist/ para a arquitetura que você estiver usando.

Depois, siga os mesmos passos da opção Lançamento para adicionar o servidor MCP às suas configurações.

Desenvolvimento

Certifique-se de ter tanto o runtime do Bun quanto a extensão Civet para VSCode/Cursor instalados.

Depois de clonar o repositório, instale suas dependências:

cd /path/to/repository
bun i

A melhor maneira de visualizar tudo funcionando é executando:

bun inspect username:password

Isso abrirá o MCP Inspector com uma interface gráfica para explorar e testar as ferramentas MCP.

Limitação das ferramentas MCP

O MCP tem uma limitação de 40 ferramentas que serão enviadas ao agente.

Atualmente, bitbucket-mcp-server fornece 24 ferramentas no total. Considere desabilitar aquelas que você não usa com frequência para economizar alguns slots.

A fazer

• Talvez implementar OAuth

---

Este projeto foi criado usando bun init no bun v1.2.17. Bun é um runtime JavaScript rápido e tudo-em-um.