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.

CodeQL GitHub-Repository Lizenz: MIT npm-Version

Related MCP server: GitHub 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:

Variable	Beschreibung	Erforderlich
`BITBUCKET_URL`	Bitbucket-Basis-URL (z. B. „ https://bitbucket.org/your-workspace “)	Ja
`BITBUCKET_USERNAME`	Ihr Bitbucket-Benutzername	Ja*
`BITBUCKET_PASSWORD`	Ihr Bitbucket-App-Passwort	Ja*
`BITBUCKET_TOKEN`	Ihr Bitbucket-Zugriffstoken (Alternative zu Benutzername/Passwort)	NEIN
`BITBUCKET_WORKSPACE`	Zu verwendender Standardarbeitsbereich, wenn nicht angegeben	NEIN

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

Erstellen eines Bitbucket-App-Passworts

Melden Sie sich bei Ihrem Bitbucket-Konto an
Gehen Sie zu Persönliche Einstellungen > App-Passwörter
Erstellen Sie ein neues App-Passwort mit den folgenden Berechtigungen:
- Repositories: Lesen
- Pull Requests: Lesen, Schreiben
Kopieren Sie das generierte Passwort und verwenden Sie es als Umgebungsvariable BITBUCKET_PASSWORD

Integration mit Cursor

So integrieren Sie diesen MCP-Server mit Cursor:

Cursor öffnen
Gehen Sie zu Einstellungen > Erweiterungen
Klicken Sie auf „Model Context Protocol“
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"] }

Speichern der Konfiguration
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 .

Bitbucket MCP

Sicherheit geht vor

Überblick

Installation

Verwendung von NPX (empfohlen)

Manuelle Installation

Konfiguration

Umgebungsvariablen

Erstellen eines Bitbucket-App-Passworts

Integration mit Cursor

Verwenden eines lokalen Builds mit Cursor

Verfügbare Tools

Repository-Operationen

listRepositories

getRepository

Pull Request-Vorgänge

getPullRequests

createPullRequest

getPullRequest

updatePullRequest

getPullRequestActivity

approvePullRequest

unapprovePullRequest

declinePullRequest

mergePullRequest

requestChanges

removeChangeRequest

Pull Request-Kommentarvorgänge

getPullRequestComments

createPullRequestComment

getPullRequestComment

updatePullRequestComment

deletePullRequestComment

resolveComment

reopenComment

Pull Request-Diff-Operationen

getPullRequestDiff

getPullRequestDiffStat

getPullRequestPatch

Pull Request-Task-Vorgänge

getPullRequestTasks

createPullRequestTask

getPullRequestTask

updatePullRequestTask

deletePullRequestTask

Andere Pull Request-Operationen

getPullRequestCommits

getPullRequestStatuses

Entwicklung

Voraussetzungen

Aufstellen

Lizenz

Links

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

`listRepositories`

`getRepository`

`getPullRequests`

`createPullRequest`

`getPullRequest`

`updatePullRequest`

`getPullRequestActivity`

`approvePullRequest`

`unapprovePullRequest`

`declinePullRequest`

`mergePullRequest`

`requestChanges`

`removeChangeRequest`

`getPullRequestComments`

`createPullRequestComment`

`getPullRequestComment`

`updatePullRequestComment`

`deletePullRequestComment`

`resolveComment`

`reopenComment`

`getPullRequestDiff`

`getPullRequestDiffStat`

`getPullRequestPatch`

`getPullRequestTasks`

`createPullRequestTask`

`getPullRequestTask`

`updatePullRequestTask`

`deletePullRequestTask`

`getPullRequestCommits`

`getPullRequestStatuses`