Bitbucket Server MCP

MCP-Server (Model Context Protocol) für das Bitbucket Server Pull Request Management. Dieser Server stellt Tools und Ressourcen bereit, um über das MCP-Protokoll mit der Bitbucket Server API zu interagieren.

✨ Neue Funktionen

• 🔧 Benutzerdefinierte HTTP-Header: Fügen Sie allen Anfragen über die Umgebungsvariable BITBUCKET_CUSTOM_HEADERS benutzerdefinierte Header hinzu (nützlich für Zero-Trust-Token oder Proxys)

• 📋 PR-Erkennung: Listen und filtern Sie Pull Requests nach Status, Autor oder Richtung mit list_pull_requests (behebt #14)

• 🌿 Branch-Management: Listen Sie Branches mit Standard-Branch-Erkennung über list_branches auf, löschen Sie zusammengeführte Branches mit delete_branch

• 📝 Commit-Verlauf: Durchsuchen Sie den Commit-Verlauf mit Branch- und Autor-Filterung über list_commits

• ✅ PR-Genehmigung: Genehmigen und widerrufen Sie Pull Requests mit approve_pull_request und unapprove_pull_request

• 🔍 Erweiterte Suche: Durchsuchen Sie Code und Dateien in Repositories mit Projekt-/Repository-Filterung über das search-Tool

• 📄 Dateioperationen: Lesen Sie Dateiinhalte und durchsuchen Sie Repository-Verzeichnisse mit get_file_content und browse_repository

• 💬 Kommentarverwaltung: Extrahieren und filtern Sie PR-Kommentare mit dem get_comments-Tool

• 🔍 Projekterkennung: Listen Sie alle zugänglichen Bitbucket-Projekte mit list_projects auf

• 📁 Repository-Durchsuchung: Erkunden Sie Repositories über Projekte hinweg mit list_repositories

• 🔧 Flexible Projektunterstützung: Machen Sie das Standardprojekt optional – geben Sie es pro Befehl an oder verwenden Sie BITBUCKET_DEFAULT_PROJECT

• 📖 Verbesserte Dokumentation: Verbesserte README mit Anwendungsbeispielen und besserer Konfigurationsanleitung

Related MCP server: GitHub PR Comments MCP Server

Anforderungen

• Node.js >= 16

Installation

Installation via Smithery

Um Bitbucket Server automatisch für Claude Desktop über Smithery zu installieren:

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

Manuelle Installation

npm install

Build

npm run build

Funktionen

Der Server bietet die folgenden Tools für eine umfassende Bitbucket Server-Integration:

list_projects

Bitbucket-Projekte entdecken und erkunden: Listet alle zugänglichen Projekte mit ihren Details auf. Unverzichtbar für die Projekterkennung und das Finden der korrekten Projektschlüssel für andere Vorgänge.

Anwendungsfälle:

• Verfügbare Projekte finden, wenn der genaue Projektschlüssel nicht bekannt ist

• Projektstruktur und Berechtigungen erkunden

• Neue Projekte entdecken, auf die Sie Zugriff haben

Parameter:

• limit: Anzahl der zurückzugebenden Projekte (Standard: 25, max: 1000)

• start: Startindex für die Paginierung (Standard: 0)

list_repositories

Repositories durchsuchen und entdecken: Erkunden Sie Repositories innerhalb bestimmter Projekte oder über alle zugänglichen Projekte hinweg. Gibt umfassende Repository-Informationen zurück, einschließlich Klon-URLs und Metadaten.

Anwendungsfälle:

• Repository-Slugs für andere Vorgänge finden

• Codebasis-Struktur über Projekte hinweg erkunden

• Repositories entdecken, auf die Sie Zugriff haben

• Repositories eines bestimmten Projekts durchsuchen

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• limit: Anzahl der zurückzugebenden Repositories (Standard: 25, max: 1000)

• start: Startindex für die Paginierung (Standard: 0)

create_pull_request

Codeänderungen zur Überprüfung vorschlagen: Erstellt einen neuen Pull Request, um Codeänderungen einzureichen, Überprüfungen anzufordern oder Feature-Branches zusammenzuführen. Handhabt automatisch Branch-Referenzen und Zuweisungen von Reviewern.

Anwendungsfälle:

• Feature-Entwicklung zur Überprüfung einreichen

• Fehlerbehebungen vorschlagen

• Code-Integration aus Feature-Branches anfordern

• An Codeänderungen zusammenarbeiten

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• title (erforderlich): Klarer, beschreibender PR-Titel

• description: Detaillierte Beschreibung mit Kontext (unterstützt Markdown)

• sourceBranch (erforderlich): Quell-Branch mit den Änderungen

• targetBranch (erforderlich): Ziel-Branch für die Zusammenführung

• reviewers: Array von Reviewer-Benutzernamen

• sourceProject: Projektschlüssel des Quell-Repositorys (für Cross-Repo-PRs aus Forks)

• sourceRepository: Slug des Quell-Repositorys (für Cross-Repo-PRs aus Forks)

• includeDefaultReviewers: Automatisch die für den Ziel-Branch konfigurierten Standard-Reviewer abrufen und einbeziehen (Standard: true)

update_pull_request

Einen Pull Request sicher aktualisieren: Ändern Sie den Titel, die Beschreibung oder die Reviewer eines bestehenden Pull Requests, ohne Metadaten zu verlieren. Verwendet ein Read-Modify-Write-Muster, um alle Felder zu bewahren, die nicht explizit geändert wurden.

Anwendungsfälle:

• PR-Titel oder -Beschreibung nach der Erstellung korrigieren

• Reviewer hinzufügen oder ersetzen, ohne bestehende zu verlieren

• PR-Metadaten aktualisieren, ohne den Genehmigungsstatus zu beeinflussen

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Zu aktualisierende Pull-Request-ID

• title: Neuer Titel (falls weggelassen, bleibt der aktuelle Titel erhalten)

• description: Neue Beschreibung (falls weggelassen, bleibt die aktuelle Beschreibung erhalten)

• reviewers: Neue Reviewer-Liste als Array von Benutzernamen (falls weggelassen, bleiben die aktuellen Reviewer erhalten)

get_pull_request

Umfassende PR-Informationen: Ruft detaillierte Pull-Request-Informationen ab, einschließlich Status, Reviewer, Commits und aller Metadaten. Unverzichtbar, um den PR-Status vor Aktionen zu verstehen.

Anwendungsfälle:

• PR-Genehmigungsstatus prüfen

• PR-Details und Fortschritt überprüfen

• Änderungen vor dem Zusammenführen verstehen

• PR-Status überwachen

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Pull-Request-ID

merge_pull_request

Genehmigte Änderungen integrieren: Führt einen genehmigten Pull Request in den Ziel-Branch zusammen. Unterstützt verschiedene Zusammenführungsstrategien basierend auf Ihren Workflow-Präferenzen.

Anwendungsfälle:

• Code-Review-Prozess abschließen

• Genehmigte Features integrieren

• Fehlerbehebungen auf Haupt-Branches anwenden

• Codeänderungen veröffentlichen

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Pull-Request-ID

• message: Benutzerdefinierte Merge-Commit-Nachricht

• strategy: Merge-Strategie:

  • merge-commit (Standard): Erstellt einen Merge-Commit unter Beibehaltung der Historie

  • squash: Kombiniert alle Commits zu einem

  • fast-forward: Verschiebt den Branch-Zeiger ohne Merge-Commit

decline_pull_request

Ungeeignete Änderungen ablehnen: Lehnt einen Pull Request ab, der nicht zusammengeführt werden sollte, und gibt dem Autor Feedback.

Anwendungsfälle:

• Änderungen ablehnen, die Standards nicht erfüllen

• PRs schließen, die der Projektrichtung widersprechen

• Wesentliche Überarbeitung anfordern

• Unerwünschte Code-Integration verhindern

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Pull-Request-ID

• message: Grund für die Ablehnung (hilfreich für Feedback an den Autor)

add_comment

Am Code-Review teilnehmen: Fügt Kommentare zu Pull Requests für Review-Feedback, Diskussionen und Zusammenarbeit hinzu. Unterstützt Thread-Konversationen.

Anwendungsfälle:

• Feedback zum Code-Review geben

• Fragen zu spezifischen Änderungen stellen

• Verbesserungen vorschlagen

• An technischen Diskussionen teilnehmen

• Review-Entscheidungen dokumentieren

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Pull-Request-ID

• text (erforderlich): Kommentarinhalt (unterstützt Markdown)

• parentId: Übergeordnete Kommentar-ID für Thread-Antworten

• state: Kommentarstatus: OPEN (Standard, sofort veröffentlicht) oder PENDING (Entwurf, nur für Sie sichtbar, bis das Review veröffentlicht wird)

get_diff

Codeänderungen analysieren: Ruft die Code-Unterschiede ab und zeigt genau, was im Pull Request hinzugefügt, entfernt oder geändert wurde. Unterstützt die Kürzung pro Datei, um große Diffs effektiv zu verwalten.

Anwendungsfälle:

• Spezifische Codeänderungen überprüfen

• Umfang der Änderungen verstehen

• Auswirkungen vor dem Zusammenführen analysieren

• Implementierungsdetails untersuchen

• Code-Qualitätsbewertung

• Große Dateien handhaben, ohne die Ausgabe zu überlasten

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Pull-Request-ID

• contextLines: Kontextzeilen um Änderungen (Standard: 10)

• maxLinesPerFile: Maximale Zeilenanzahl pro Datei (optional, verwendet BITBUCKET_DIFF_MAX_LINES_PER_FILE Umgebungsvariable, falls nicht angegeben; auf 0 setzen für kein Limit)

Handhabung großer Dateien: Wenn eine Datei das maxLinesPerFile-Limit überschreitet, wird Folgendes angezeigt:

• Datei-Header und Metadaten (immer beibehalten)

• Erste 60% der erlaubten Zeilen vom Anfang

• Kürzungsmeldung mit Dateistatistiken

• Letzte 40% der erlaubten Zeilen vom Ende

• Klare Angabe, wie der vollständige Diff angezeigt werden kann

get_reviews

Review-Fortschritt verfolgen: Ruft die Review-Historie, den Genehmigungsstatus und das Feedback der Reviewer ab, um den Review-Status zu verstehen.

Anwendungsfälle:

• Prüfen, ob der PR bereit zum Zusammenführen ist

• Sehen, wer die Änderungen überprüft hat

• Review-Feedback verstehen

• Genehmigungsanforderungen überwachen

• Review-Fortschritt verfolgen

get_activities

Pull-Request-Aktivitäten abrufen: Ruft die vollständige Aktivitäts-Timeline für einen Pull Request ab, einschließlich Kommentaren, Reviews, Commits und anderen Ereignissen.

Anwendungsfälle:

• Kommentardiskussionen und Feedback lesen

• Die vollständige PR-Timeline überprüfen

• Commits verfolgen, die zum PR hinzugefügt/entfernt wurden

• Genehmigungs- und Review-Historie sehen

• Den vollständigen PR-Lebenszyklus verstehen

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Pull-Request-ID

get_comments

Nur PR-Kommentare extrahieren: Filtert Pull-Request-Aktivitäten, um nur die Kommentare zurückzugeben, was es einfacher macht, sich auf den Diskussionsinhalt ohne Reviews oder andere Aktivitäten zu konzentrieren.

Anwendungsfälle:

• PR-Diskussions-Threads lesen

• Feedback und Fragen extrahieren

• Auf Kommentarinhalt ohne Rauschen konzentrieren

• Konversationsfluss analysieren

Parameter:

• project: Bitbucket-Projektschlüssel (optional, verwendet BITBUCKET_DEFAULT_PROJECT, falls nicht angegeben)

• repository (erforderlich): Repository-Slug

• prId (erforderlich): Pull-Request-ID

search

Erweiterte Code- und Dateisuche: Durchsuchen Sie Repositories mit der Bitbucket-Such-API mit Unterstützung für Projekt-/Repository-Filterung und Abfrageoptimierung. Durchsucht sowohl Dateiinhalte als auch Dateinamen. Hinweis: Die Suche funktioniert nur auf dem Standard-Branch von Repositories.

Anwendungsfälle:

• Spezifische Codemuster über Projekte hinweg finden

• Dateien nach Name oder Inhalt lokalisieren

• Innerhalb bestimmter Projekte oder Repositories suchen

• Nach Dateiendungen filtern

Parameter:

• query (erforderlich): Suchabfrage-String

• project: Bitbucket-Projektschlüssel zur Begrenzung des Suchbereichs

• repository: Repository-Slug für Repository-spezifische Suche

• type: Abfrageoptimierung - "file" (setzt Abfrage in Anführungszeichen für exakte Dateinamenübereinstimmung) oder "code" (Standard-Suchverhalten)

• limit: Anzahl der zurückzugebenden Ergebnisse (Standard: 25, max: 100)

• start: Startindex für die Paginierung (Standard: 0)

Beispiele für Abfragesyntax:

• "README.md" - Exakten Dateinamen finden

• config ext:yml - Konfiguration in YAML-Dateien finden

• function project:MYPROJECT - Nach "function" in einem bestimmten Projekt suchen

• bug fix repo:PROJ/my-repo - In einem bestimmten Repository suchen

get_file_content

Dateiinhalte mit Paginierung lesen: Rufen Sie den Inhalt