Bitbucket MCP

Ein Model Context Protocol (MCP)-Server, der die Cursor IDE mit Bitbucket Cloud integriert und es Ihnen ermöglicht, Repository-Informationen und Commit-Daten direkt aus Ihrem Bitbucket-Workspace abzurufen.

Funktionen

• Repositories auflisten: Alle Repositories aus Ihrem Bitbucket-Workspace abrufen

• Repository-Details: Detaillierte Informationen zu bestimmten Repositories erhalten

• Commit-Informationen: Commit-Verlauf und Details zum letzten Commit abrufen

• Commit-Anzahl: Gesamtzahl der Commits pro Repository abrufen

• Daten zum letzten Commit: Datum, Autor und Nachricht des letzten Commits für jedes Repository abrufen

• Workspaces: Alle verfügbaren Workspaces auflisten.

• Pull Requests: Pull Requests erstellen, anzeigen, auflisten und aktualisieren, einschließlich Lesen und Hinzufügen von PR-Kommentaren.

• Projekte: Projektdetails anzeigen und Standard-Reviewer auflisten.

• Branch-Beschränkungen: Branch-Beschränkungen für Projekte und Repositories verwalten.

• Commits: Einzelne Commits und Listen von Commits abrufen.

Related MCP server: JIRA MCP Server

Voraussetzungen

• Node.js 18 oder höher

• npm oder yarn

• Ein Bitbucket Cloud-Konto

• Bitbucket App-Passwort (zur Authentifizierung)

Einrichtung

1. Abhängigkeiten installieren

npm install

2. Das Projekt bauen

npm run build

3. Atlassian API-Token erstellen*

• Wenn Sie bereits ein Token für Jira oder Confluence haben, können Sie dieses wiederverwenden *

1. Gehen Sie zu Ihren Bitbucket-Kontoeinstellungen

2. Navigieren Sie unter "Zugriffsverwaltung" zu "App-Passwörter"

3. Anstatt auf "App-Passwort erstellen" zu klicken (veraltet), navigieren Sie zu "Zu API-Token gehen"

4. Erstellen Sie ein API-Token

5. Geben Sie ihm einen aussagekräftigen Namen (z. B. "Cursor MCP Integration")

6. Wählen Sie ein Ablaufdatum

7. Kopieren Sie das generierte Token

4. Umgebungsvariablen konfigurieren

Erstellen Sie eine .env-Datei im Projektstammverzeichnis:

BITBUCKET_USERNAME=your_bitbucket_email_address
BITBUCKET_APP_PASSWORD=your_api_token
BITBUCKET_WORKSPACE=your_workspace_name

Hinweis: Der Workspace-Name ist normalerweise Ihr Benutzername oder Organisationsname. Sie finden ihn in Ihren Bitbucket-URLs (z. B. https://bitbucket.org/workspace_name/).

5. Zur Cursor MCP-Konfiguration hinzufügen

Fügen Sie die folgende Konfiguration zu Ihren Cursor MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["@korfu/bitbucket-mcp"],
      "env": {
        "BITBUCKET_USERNAME": "your_bitbucket_email_address",
        "BITBUCKET_APP_PASSWORD": "your_api_token",
        "BITBUCKET_WORKSPACE": "your_workspace_name"
      }
    }
  }
}

6. Cursor neu starten

Starten Sie nach dem Hinzufügen der Konfiguration die Cursor IDE neu, um den MCP-Server zu laden.

Verwendung

Sobald die Konfiguration abgeschlossen ist, können Sie die folgenden Tools in Cursor verwenden:

Workspaces

• bitbucket_list_workspaces

Repositories

• bitbucket_list_repositories

• bitbucket_get_repository_details

Commits

• bitbucket_list_commits

• bitbucket_get_commit

Pull Requests

• bitbucket_list_pull_requests

• bitbucket_get_pull_request

• bitbucket_create_pull_request

• bitbucket_update_pull_request

• bitbucket_list_pull_request_comments

• bitbucket_get_pull_request_comment

• bitbucket_add_pull_request_comment

Projekte

• bitbucket_get_project

• bitbucket_list_default_reviewers

Branch-Beschränkungen

• bitbucket_list_branch_restrictions

• bitbucket_get_branch_restriction

• bitbucket_update_repository_branching_model_settings

• bitbucket_update_project_branching_model_settings

Verfügbare Tools

Workspaces

• list_workspaces: Listet alle Workspaces auf, auf die der aktuelle Benutzer Zugriff hat.

Repositories

• list_repositories: Listet alle Repositories im konfigurierten Bitbucket-Workspace auf.

• get_repository_details: Ruft detaillierte Informationen zu einem bestimmten Repository ab, einschließlich Informationen zum letzten Commit.

Commits

• list_commits: Ruft Commit-Informationen für ein bestimmtes Repository ab.

• get_commit: Ruft einen einzelnen Commit über seinen Hash ab.

Pull Requests

• list_pull_requests: Listet alle Pull Requests in einem Repository auf.

• get_pull_request: Ruft einen einzelnen Pull Request über seine ID ab.

• create_pull_request: Erstellt einen neuen Pull Request. //Beta-Version - ungetestet

• update_pull_request: Aktualisiert einen bestehenden Pull Request. //Beta-Version - ungetestet

• list_pull_request_comments: Listet alle Kommentare zu einem Pull Request auf (global, inline und Antworten) mit Unterstützung für Paginierung.

• get_pull_request_comment: Ruft einen einzelnen Kommentar zu einem Pull Request über seine ID ab, einschließlich Inline-Datei-/Zeilenkontext.

• add_pull_request_comment: Fügt einem Pull Request einen Kommentar hinzu. Unterstützt allgemeine Kommentare, Inline-Kommentare zu bestimmten Dateien/Zeilen und Thread-Antworten.

Projekte

• get_project: Ruft ein einzelnes Projekt über seinen Schlüssel ab.

• list_default_reviewers: Listet Standard-Reviewer für ein Projekt auf.

Branch-Beschränkungen

• list_branch_restrictions: Listet alle Branch-Beschränkungen für ein Repository auf.

• get_branch_restriction: Ruft eine einzelne Branch-Beschränkung über ihre ID ab.

• update_repository_branching_model_settings: Aktualisiert die Konfiguration des Branching-Modells für ein Repository. //Beta-Version - ungetestet

• update_project_branching_model_settings: Aktualisiert die Konfiguration des Branching-Modells für ein Projekt. //Beta-Version - ungetestet

Entwicklung

Ausführen im Entwicklungsmodus

npm run dev

Bauen

npm run build

Projektstruktur

BitbucketMCP/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── .gitignore           # Git ignore rules
└── README.md            # This file

Fehlerbehebung

Authentifizierungsprobleme

• Überprüfen Sie, ob Ihr Bitbucket-Benutzername und Ihr App-Passwort korrekt sind

• Stellen Sie sicher, dass das App-Passwort über die richtigen Berechtigungen verfügt (Repositories: Lesen)

• Überprüfen Sie, ob der Workspace-Name korrekt ist

Verbindungsprobleme

• Überprüfen Sie Ihre Internetverbindung

• Prüfen Sie, ob die Bitbucket-API aus Ihrem Netzwerk erreichbar ist

• Stellen Sie sicher, dass der MCP-Server läuft (überprüfen Sie die MCP-Protokolle von Cursor)

Repository nicht gefunden

• Überprüfen Sie, ob der Repository-Name korrekt ist (verwenden Sie den Repo-Slug, nicht den Anzeigenamen)

• Stellen Sie sicher, dass Sie Zugriff auf das Repository haben

• Überprüfen Sie, ob das Repository im angegebenen Workspace existiert

MCP-Server lädt nicht

• Überprüfen Sie, ob der Pfad zu dist/index.js in Ihrer Cursor-Konfiguration korrekt ist

• Stellen Sie sicher, dass Node.js installiert und über die Befehlszeile zugänglich ist

• Überprüfen Sie die MCP-Server-Protokolle von Cursor auf Fehlermeldungen

Sicherheitshinweise

• Bewahren Sie Ihr Bitbucket-App-Passwort sicher auf und committen Sie es niemals in die Versionskontrolle

• Verwenden Sie Umgebungsvariablen oder eine sichere Konfigurationsverwaltung für Anmeldeinformationen

• Das App-Passwort sollte nur über die minimal erforderlichen Berechtigungen verfügen

• Erwägen Sie, Ihr App-Passwort regelmäßig zu rotieren

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch

3. Führen Sie Ihre Änderungen durch

4. Fügen Sie gegebenenfalls Tests hinzu

5. Senden Sie einen Pull Request

Lizenz

MIT-Lizenz - siehe LICENSE-Datei für Details