Bitbucket MCP

Ein Model Context Protocol (MCP)-Server zur Integration mit Bitbucket Cloud und Server-APIs. Dieser MCP-Server ermöglicht KI-Assistenten wie Cursor die Interaktion mit Ihren Bitbucket-Repositories, Pull Requests und anderen Ressourcen.

Sicherheit geht vor

Dies ist ein sicheres und verantwortungsvolles Paket – es werden keine DELETE-Operationen verwendet, sodass kein Risiko eines Datenverlusts besteht. Jeder Pull Request wird mit CodeQL analysiert, um die Sicherheit des Codes zu gewährleisten.

Related MCP server: Bitbucket MCP Server

Überblick

Schauen Sie sich das offizielle npm-Paket an. Dieser Server implementiert den Model Context Protocol-Standard, um KI-Assistenten Zugriff auf Bitbucket-Daten und -Operationen zu ermöglichen. Es enthält Tools für:

• Auflisten und Abrufen von Repositories

• Abrufen von Repository-Details

• Abrufen von Pull Requests

• Und mehr...

Installation

Verwendung von NPX (empfohlen)

Am einfachsten lässt sich dieser MCP-Server über NPX verwenden. Dadurch können Sie ihn ausführen, ohne ihn global zu installieren:

# Run with environment variables
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx -y bitbucket-mcp@latest

Manuelle Installation

Alternativ können Sie es global oder als Teil Ihres Projekts installieren:

# Install globally
npm install -g bitbucket-mcp

# Or install in your project
npm install bitbucket-mcp

Führen Sie es dann mit folgendem Befehl aus:

# If installed globally
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
bitbucket-mcp

# If installed in your project
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx bitbucket-mcp

Konfiguration

Umgebungsvariablen

Konfigurieren Sie den Server mit den folgenden Umgebungsvariablen:

* Es müssen entweder BITBUCKET_TOKEN oder sowohl BITBUCKET_USERNAME als auch BITBUCKET_PASSWORD angegeben werden.

Erstellen eines Bitbucket-App-Passworts

1. Melden Sie sich bei Ihrem Bitbucket-Konto an

2. Gehen Sie zu Persönliche Einstellungen > App-Passwörter

3. Erstellen Sie ein neues App-Passwort mit den folgenden Berechtigungen:

   • Repositories: Lesen

   • Pull Requests: Lesen, Schreiben

4. Kopieren Sie das generierte Passwort und verwenden Sie es als Umgebungsvariable BITBUCKET_PASSWORD

Integration mit Cursor

So integrieren Sie diesen MCP-Server mit Cursor:

1. Cursor öffnen

2. Gehen Sie zu Einstellungen > Erweiterungen

3. Klicken Sie auf „Model Context Protocol“

4. Fügen Sie eine neue MCP-Konfiguration hinzu:

"bitbucket": {
  "command": "npx",
  "env": {
    "BITBUCKET_URL": "https://bitbucket.org/your-workspace",
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_PASSWORD": "your-app-password"
  },
  "args": ["-y", "bitbucket-mcp@latest"]
}

5. Speichern der Konfiguration

6. Verwenden Sie den Befehl "/bitbucket" im Cursor, um auf Bitbucket-Repositorys und Pull-Anfragen zuzugreifen

Verwenden eines lokalen Builds mit Cursor

Wenn Sie lokal entwickeln und Ihre Änderungen testen möchten:

"bitbucket-local": {
  "command": "node",
  "env": {
    "BITBUCKET_URL": "https://bitbucket.org/your-workspace",
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_PASSWORD": "your-app-password"
  },
  "args": ["/path/to/your/local/bitbucket-mcp/dist/index.js"]
}

Verfügbare Tools

Dieser MCP-Server bietet Tools für die Interaktion mit Bitbucket-Repositories und Pull Requests. Nachfolgend finden Sie eine umfassende Liste der verfügbaren Operationen:

Repository-Operationen

listRepositories

Listet Repositories in einem Arbeitsbereich auf.

Parameter:

• workspace (optional): Name des Bitbucket-Arbeitsbereichs

• limit (optional): Maximale Anzahl der zurückzugebenden Repositories

getRepository

Ruft Details zu einem bestimmten Repository ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

Pull Request-Vorgänge

getPullRequests

Ruft Pull Requests für ein Repository ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• state (optional): Status der Pull-Anfrage ( OPEN , MERGED , DECLINED , SUPERSEDED )

• limit (optional): Maximale Anzahl der zurückzugebenden Pull Requests

createPullRequest

Erstellt eine neue Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• title : Pull-Request-Titel

• description : Pull-Request-Beschreibung

• sourceBranch : Name des Quellzweigs

• targetBranch : Name des Zielzweigs

• reviewers (optional): Liste der Benutzernamen der Gutachter

getPullRequest

Ruft Details zu einer bestimmten Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

updatePullRequest

Aktualisiert eine Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• Verschiedene optionale Update-Parameter (Titel, Beschreibung usw.)

getPullRequestActivity

Ruft das Aktivitätsprotokoll für eine Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

approvePullRequest

Genehmigt eine Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

unapprovePullRequest

Entfernt eine Genehmigung aus einer Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

declinePullRequest

Lehnt eine Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• message (optional): Grund für die Ablehnung

mergePullRequest

Führt eine Pull-Anfrage zusammen.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• message (optional): Merge-Commit-Nachricht

• strategy (optional): Merge-Strategie ( merge-commit , squash , fast-forward )

requestChanges

Fordert Änderungen an einer Pull-Anfrage an.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

removeChangeRequest

Entfernt eine Änderungsanforderung aus einer Pull-Anforderung.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

Pull Request-Kommentarvorgänge

getPullRequestComments

Listet Kommentare zu einer Pull-Anfrage auf.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

createPullRequestComment

Erstellt einen Kommentar zu einer Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• content : Kommentarinhalt

• inline (optional): Inline-Kommentarinformationen

getPullRequestComment

Ruft einen bestimmten Kommentar zu einer Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• comment_id : Kommentar-ID

updatePullRequestComment

Aktualisiert einen Kommentar zu einer Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• comment_id : Kommentar-ID

• content : Aktualisierter Kommentarinhalt

deletePullRequestComment

Löscht einen Kommentar zu einer Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• comment_id : Kommentar-ID

resolveComment

Löst einen Kommentarthread zu einer Pull-Anfrage auf.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• comment_id : Kommentar-ID

reopenComment

Öffnet einen aufgelösten Kommentarthread zu einer Pull-Anfrage erneut.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• comment_id : Kommentar-ID

Pull Request-Diff-Operationen

getPullRequestDiff

Ruft den Diff für eine Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

getPullRequestDiffStat

Ruft die Diff-Statistiken für eine Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

getPullRequestPatch

Ruft den Patch für eine Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

Pull Request-Task-Vorgänge

getPullRequestTasks

Listet Aufgaben in einer Pull-Anfrage auf.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

createPullRequestTask

Erstellt eine Aufgabe für eine Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• content : Aufgabeninhalt

• comment (optional): Kommentar-ID, die der Aufgabe zugeordnet werden soll

• pending (optional): Ob die Aufgabe aussteht

getPullRequestTask

Ruft eine bestimmte Aufgabe für eine Pull-Anfrage ab.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• task_id : Aufgaben-ID

updatePullRequestTask

Aktualisiert eine Aufgabe bei einer Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• task_id : Aufgaben-ID

• content (optional): Aktualisierter Aufgabeninhalt

• state (optional): Aktualisierter Aufgabenstatus

deletePullRequestTask

Löscht eine Aufgabe in einer Pull-Anfrage.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

• task_id : Aufgaben-ID

Andere Pull Request-Operationen

getPullRequestCommits

Listet Commits zu einem Pull Request auf.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

getPullRequestStatuses

Listet Commit-Status für eine Pull-Anfrage auf.

Parameter:

• workspace : Name des Bitbucket-Arbeitsbereichs

• repo_slug : Repository-Slug

• pull_request_id : Pull-Request-ID

Entwicklung

Voraussetzungen

• Node.js 18 oder höher

• npm oder yarn

Aufstellen

# Clone the repository
git clone https://github.com/MatanYemini/bitbucket-mcp.git
cd bitbucket-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Links

• GitHub-Repository

• npm-Paket

• Modellkontextprotokoll

• Bitbucket REST API – Pull Requests