mcp-bitbucket

MCP-Server (stdio) für die Bitbucket Cloud REST API 2.0. Funktioniert mit Cursor: Pull Requests, Pipelines, Logs, Clone.

Die Tools entsprechen dem typischen Satz bb_get / bb_post / bb_put / bb_patch / bb_delete / bb_clone.

Voraussetzungen

• Node.js 18+

• Scoped API Token von Atlassian (App-Passwörter funktionieren nicht)

Token: id.atlassian.com → API tokens.
Nützliche Bereiche: Lesen von Repository, Pull Requests, Pipelines und Benutzer (read:repository:bitbucket, read:pullrequest:bitbucket, read:pipeline:bitbucket, read:user:bitbucket). Für Schreibzugriff entsprechende write:*-Bereiche hinzufügen.

Related MCP server: Bitbucket Cloud MCP Server

Installation

git clone https://github.com/genkis/mcp-bitbucket.git
cd mcp-bitbucket
npm install

Kopiere .env.example in .env und fülle die Werte lokal aus. Die Datei .env nicht committen.

Cursor (~/.cursor/mcp.json)

Token und E-Mail nur in der lokalen Cursor-Konfiguration aufbewahren, nicht in diesem Repository.

{
  "mcpServers": {
    "bitbucket": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp-bitbucket/index.js"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-scoped-api-token",
        "BITBUCKET_DEFAULT_WORKSPACE": "your-workspace-slug"
      }
    }
  }
}

Nach Änderungen die MCP-Server in Cursor neu laden.

Variablen:

Aliasse: BITBUCKET_USERNAME, BITBUCKET_API_TOKEN.

Tools

Das Präfix /2.0 wird automatisch hinzugefügt. Der Pfad beginnt mit /, z. B. /workspaces.

Gemeinsame Parameter: path, optional queryParams, jq (JMESPath), outputFormat (toon oder json). bb_post / bb_put / bb_patch erfordern body.

Beispiele für Pfade:

• /workspaces

• /repositories/{workspace}/{repo}/pullrequests/{id}

• /repositories/{workspace}/{repo}/pullrequests/{id}/diff

• /repositories/{workspace}/{repo}/pipelines/?pagelen=50&sort=-created_on

• /repositories/{workspace}/{repo}/pipelines/{uuid}/steps/{stepUuid}/log

Der jq-Filter sollte bei Listen immer verwendet werden, um nicht das gesamte JSON in das Modell zu ziehen.

Sicherheit

• Keine Tokens, .env oder mcp.json mit Geheimnissen committen.

• Dieser Server leitet nur Anfragen an api.bitbucket.org mit Basic Auth (E-Mail + Token) weiter.

• Logs und Fehler geben den Token nicht aus.