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.
Ü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:
Manuelle Installation
Alternativ können Sie es global oder als Teil Ihres Projekts installieren:
Führen Sie es dann mit folgendem Befehl aus:
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:
- 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:
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-Arbeitsbereichslimit
(optional): Maximale Anzahl der zurückzugebenden Repositories
getRepository
Ruft Details zu einem bestimmten Repository ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slug
Pull Request-Vorgänge
getPullRequests
Ruft Pull Requests für ein Repository ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugstate
(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-Arbeitsbereichsrepo_slug
: Repository-Slugtitle
: Pull-Request-Titeldescription
: Pull-Request-BeschreibungsourceBranch
: Name des QuellzweigstargetBranch
: Name des Zielzweigsreviewers
(optional): Liste der Benutzernamen der Gutachter
getPullRequest
Ruft Details zu einer bestimmten Pull-Anfrage ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
updatePullRequest
Aktualisiert eine Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_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-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
approvePullRequest
Genehmigt eine Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
unapprovePullRequest
Entfernt eine Genehmigung aus einer Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
declinePullRequest
Lehnt eine Pull-Anfrage ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDmessage
(optional): Grund für die Ablehnung
mergePullRequest
Führt eine Pull-Anfrage zusammen.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDmessage
(optional): Merge-Commit-Nachrichtstrategy
(optional): Merge-Strategie (merge-commit
,squash
,fast-forward
)
requestChanges
Fordert Änderungen an einer Pull-Anfrage an.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
removeChangeRequest
Entfernt eine Änderungsanforderung aus einer Pull-Anforderung.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
Pull Request-Kommentarvorgänge
getPullRequestComments
Listet Kommentare zu einer Pull-Anfrage auf.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
createPullRequestComment
Erstellt einen Kommentar zu einer Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDcontent
: Kommentarinhaltinline
(optional): Inline-Kommentarinformationen
getPullRequestComment
Ruft einen bestimmten Kommentar zu einer Pull-Anfrage ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDcomment_id
: Kommentar-ID
updatePullRequestComment
Aktualisiert einen Kommentar zu einer Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDcomment_id
: Kommentar-IDcontent
: Aktualisierter Kommentarinhalt
deletePullRequestComment
Löscht einen Kommentar zu einer Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDcomment_id
: Kommentar-ID
resolveComment
Löst einen Kommentarthread zu einer Pull-Anfrage auf.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDcomment_id
: Kommentar-ID
reopenComment
Öffnet einen aufgelösten Kommentarthread zu einer Pull-Anfrage erneut.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDcomment_id
: Kommentar-ID
Pull Request-Diff-Operationen
getPullRequestDiff
Ruft den Diff für eine Pull-Anfrage ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
getPullRequestDiffStat
Ruft die Diff-Statistiken für eine Pull-Anfrage ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
getPullRequestPatch
Ruft den Patch für eine Pull-Anfrage ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
Pull Request-Task-Vorgänge
getPullRequestTasks
Listet Aufgaben in einer Pull-Anfrage auf.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
createPullRequestTask
Erstellt eine Aufgabe für eine Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDcontent
: Aufgabeninhaltcomment
(optional): Kommentar-ID, die der Aufgabe zugeordnet werden sollpending
(optional): Ob die Aufgabe aussteht
getPullRequestTask
Ruft eine bestimmte Aufgabe für eine Pull-Anfrage ab.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDtask_id
: Aufgaben-ID
updatePullRequestTask
Aktualisiert eine Aufgabe bei einer Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDtask_id
: Aufgaben-IDcontent
(optional): Aktualisierter Aufgabeninhaltstate
(optional): Aktualisierter Aufgabenstatus
deletePullRequestTask
Löscht eine Aufgabe in einer Pull-Anfrage.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-IDtask_id
: Aufgaben-ID
Andere Pull Request-Operationen
getPullRequestCommits
Listet Commits zu einem Pull Request auf.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
getPullRequestStatuses
Listet Commit-Status für eine Pull-Anfrage auf.
Parameter:
workspace
: Name des Bitbucket-Arbeitsbereichsrepo_slug
: Repository-Slugpull_request_id
: Pull-Request-ID
Entwicklung
Voraussetzungen
- Node.js 18 oder höher
- npm oder yarn
Aufstellen
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .
Links
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Ein Model Context Protocol-Server, der es KI-Assistenten ermöglicht, über Bitbucket Cloud- und Server-APIs mit Bitbucket-Repositorys, Pull Requests und anderen Ressourcen zu interagieren.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.Last updated -1JavaScript
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.Last updated -129Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to perform GitHub operations including repository management, file operations, issue tracking, and pull request creation.Last updated -1TypeScript
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -16TypeScript