convez.ai
MCP ServerIntegração & APIsIntermediário
mustaqeemtariq

Bitbucket Cloud MCP Server

mustaqeemtariq/bitbucket-cloud-mcp-server

Integre Bitbucket Cloud com Claude e ferramentas MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta clientes AI compatíveis ao Bitbucket Cloud, permitindo gerenciamento completo de repositórios, pull requests, commits e reviews. Fornece acesso programático a operações como listar, criar, atualizar, aprovar e fazer merge de PRs diretamente pela IA.

Instalação

$npx convez-ai mustaqeemtariq/bitbucket-cloud-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar revisão de pull requests com IA
  • Gerenciar repositórios e branches remotamente
  • Integrar Bitbucket em workflows de agentes de IA

Veredito

MCP server bem estruturado para integração Bitbucket-Claude com suporte completo a PRs e repositórios. Requer credenciais Bitbucket configuradas e é ideal para times que centralizam fluxo de código no Bitbucket.

README

A tradução para o português deste README ainda está na fila.

Bitbucket Cloud MCP Server

npm version

A Model Context Protocol (MCP) server that lets MCP-compatible AI clients work with Bitbucket Cloud repositories, pull requests, commits, comments, approvals, and merges.

Features

  • List repositories in a Bitbucket workspace
  • List, inspect, create, update, approve, merge, and comment on pull requests
  • Fetch pull request metadata, commits, comments, and diff content for reviews
  • List repository commits
  • Read-only annotations on safe exploration tools
  • Runs over MCP stdio for clients such as Claude Desktop, Cursor, Kiro, and MCP Inspector

Requirements

  • Node.js 18 or newer
  • A Bitbucket Cloud workspace
  • A Bitbucket API token or app password with repository and pull request access

Installation

Run without installing:

npx bitbucket-cloud-mcp-server

Or install globally:

npm install -g bitbucket-cloud-mcp-server
bitbucket-cloud-mcp-server

Configuration

Set these environment variables in your MCP client configuration:

VariableDescription
BITBUCKET_WORKSPACEBitbucket workspace slug
BITBUCKET_EMAILAtlassian account email
BITBUCKET_TOKENBitbucket API token or app password

Example:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "bitbucket-cloud-mcp-server"],
      "env": {
        "BITBUCKET_WORKSPACE": "my-workspace",
        "BITBUCKET_EMAIL": "my-email@example.com",
        "BITBUCKET_TOKEN": "my-api-token"
      }
    }
  }
}

If you installed the package globally, you can use the binary directly:

{
  "mcpServers": {
    "bitbucket": {
      "command": "bitbucket-cloud-mcp-server",
      "env": {
        "BITBUCKET_WORKSPACE": "my-workspace",
        "BITBUCKET_EMAIL": "my-email@example.com",
        "BITBUCKET_TOKEN": "my-api-token"
      }
    }
  }
}

Verify Credentials

Before running the MCP server, verify Bitbucket access:

curl -u "my-email@example.com:my-api-token" \
  "https://api.bitbucket.org/2.0/repositories/my-workspace"

A successful response returns repository information for the workspace.

Tools

list_repositories

Lists repositories in the configured workspace.

Input:

{
  "includePrivate": true
}

list_pull_requests

Lists pull requests for a repository.

Input:

{
  "repo": "my-repository"
}

get_pull_request

Gets pull request details.

Input:

{
  "repo": "my-repository",
  "id": 123
}

review_pull_request

Returns pull request metadata, commits, existing comments, and diff content for review.

Input:

{
  "repo": "my-repository",
  "id": 123
}

create_pull_request

Creates a pull request.

Input:

{
  "repo": "my-repository",
  "title": "Add authentication",
  "source": "feature/auth",
  "destination": "main",
  "description": "Adds login functionality"
}

update_pull_request

Updates an existing pull request's title, description, destination branch, or reviewers. All fields are optional — only provided fields are updated.

Input:

{
  "repo": "my-repository",
  "id": 123,
  "title": "Updated title",
  "description": "Updated description",
  "destination": "develop",
  "reviewers": ["{user-uuid-1}", "{user-uuid-2}"]
}

approve_pull_request

Approves a pull request.

Input:

{
  "repo": "my-repository",
  "id": 123
}

Bitbucket may prevent users from approving their own pull requests depending on repository settings.

merge_pull_request

Merges a pull request.

Input:

{
  "repo": "my-repository",
  "id": 123
}

comment_pull_request

Adds a comment to a pull request. Optionally provide filePath and line to make it an inline comment on a specific line in the diff.

General comment:

{
  "repo": "my-repository",
  "id": 123,
  "comment": "Looks good to me."
}

Inline comment on a specific file and line:

{
  "repo": "my-repository",
  "id": 123,
  "comment": "Consider renaming this variable.",
  "filePath": "src/index.ts",
  "line": 42
}

request_changes

Requests changes on a pull request, signaling the author needs to address feedback.

Input:

{
  "repo": "my-repository",
  "id": 123
}

list_commits

Lists commits for a repository.

Input:

{
  "repo": "my-repository"
}

Development

Install dependencies:

npm install

Run in development mode:

npm run dev

Build:

npm run build

Preview the npm package contents:

npm run pack:dry-run

Publishing

The unscoped bitbucket-mcp package name is already used on npm, so this package is configured as bitbucket-cloud-mcp-server.

Before publishing, confirm you are logged in:

npm whoami

Then publish:

npm publish --access public

The prepublishOnly script rebuilds dist before publishing.

License

ISC

Ver o original no GitHub

Bom para

Relacionados