Atlassian Bitbucket MCP Server

Ein Node.js/TypeScript Model Context Protocol (MCP)-Server für Atlassian Bitbucket Cloud. Ermöglicht KI-Systemen (z. B. LLMs wie Claude oder Cursor AI) die sichere Interaktion mit Ihren Repositories, Pull Requests, Arbeitsbereichen und Ihrem Code in Echtzeit.

NPM-Version Build-Status

Warum diesen Server verwenden?

Minimaler Input, maximaler Output : Einfache Kennungen liefern umfassende Details, ohne dass zusätzliche Flags erforderlich sind.
Umfangreiche Code-Visualisierung : Erhalten Sie detaillierte Einblicke in Codeänderungen mit Dateistatistiken, Diff-Ansichten und intelligentem Kontext.
Sichere lokale Authentifizierung : Führen Sie die Authentifizierung lokal mit Ihren Anmeldeinformationen aus und speichern Sie Token niemals auf Remote-Servern.
Intuitive Markdown-Antworten : Gut strukturierte, konsistente Markdown-Formatierung für alle Ausgaben.
Vollständige Bitbucket-Integration : Zugriff auf Arbeitsbereiche, Repositories, Pull-Anfragen, Kommentare, Codesuche und mehr.

Was ist MCP?

Model Context Protocol (MCP) ist ein offener Standard für die sichere Verbindung von KI-Systemen mit externen Tools und Datenquellen. Dieser Server implementiert MCP für Bitbucket Cloud und ermöglicht KI-Assistenten die programmgesteuerte Interaktion mit Ihren Bitbucket-Daten.

Voraussetzungen

Node.js (>=18.x): Herunterladen
Bitbucket Cloud-Konto

Aufstellen

Schritt 1: Authentifizieren

Wählen Sie eine der folgenden Authentifizierungsmethoden:

Option A: Bitbucket-App-Passwort (empfohlen)

Generieren Sie eines aus Bitbucket App Passwords . Mindestberechtigungen:

Arbeitsbereiche: Lesen
Repositories: Lesen
Pull Requests: Lesen

Sie können auch BITBUCKET_DEFAULT_WORKSPACE festlegen, um einen Standardarbeitsbereich anzugeben, wenn dieser nicht explizit angegeben ist.

Option B: Atlassian API Token

Generieren Sie eines aus Atlassian API-Tokens .

Hinweis: Es werden dringend Bitbucket-App-Passwörter empfohlen, da sie detailliertere, Bitbucket-spezifische Berechtigungen bieten.

Schritt 2: Anmeldeinformationen konfigurieren

Option A: MCP-Konfigurationsdatei (empfohlen)

Bearbeiten oder erstellen Sie ~/.mcp/configs.json :

Verwenden des Bitbucket-App-Passworts:

{
	"bitbucket": {
		"environments": {
			"ATLASSIAN_BITBUCKET_USERNAME": "<your_username>",
			"ATLASSIAN_BITBUCKET_APP_PASSWORD": "<your_app_password>"
		}
	}
}

Verwenden des Atlassian API-Tokens:

{
	"bitbucket": {
		"environments": {
			"ATLASSIAN_SITE_NAME": "bitbucket",
			"ATLASSIAN_USER_EMAIL": "<your_email>",
			"ATLASSIAN_API_TOKEN": "<your_api_token>"
		}
	}
}

Option B: Umgebungsvariablen

export ATLASSIAN_BITBUCKET_USERNAME="<your_username>"
export ATLASSIAN_BITBUCKET_APP_PASSWORD="<your_app_password>"

Schritt 3: Installieren und Ausführen

Schnellstart mit `npx`

npx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces

Globale Installation

npm install -g @aashari/mcp-server-atlassian-bitbucket
mcp-atlassian-bitbucket ls-workspaces

Schritt 4: Mit dem AI Assistant verbinden

Konfigurieren Sie Ihren MCP-kompatiblen Client (z. B. Claude, Cursor AI):

{
	"mcpServers": {
		"bitbucket": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
		}
	}
}

MCP-Werkzeuge

MCP-Tools verwenden snake_case -Namen, camelCase -Parameter und geben Antworten im Markdown-Format zurück.

bb_ls_workspaces : Listet verfügbare Arbeitsbereiche auf ( query : str opt). Verwendung: Verfügbare Arbeitsbereiche anzeigen.
bb_get_workspace : Ruft Arbeitsbereichsdetails ab ( workspaceSlug : str req). Verwendung: Arbeitsbereichsinformationen anzeigen.
bb_ls_repos : Listet Repositories auf ( workspaceSlug : str opt, projectKey : str opt, query : str opt, role : str opt). Verwendung: Repositories suchen.
bb_get_repo : Ruft Repository-Details ab ( workspaceSlug : str req, repoSlug : str req). Verwendung: Zugriff auf Repository-Informationen.
bb_search : Durchsucht Bitbucket-Inhalte ( workspaceSlug : str req, query : str req, scope : str opt, language : str opt, extension : str opt). Verwendung: Code oder PRs finden.
bb_ls_prs : Listet Pull Requests auf ( workspaceSlug : str req, repoSlug : str req, state : str opt). Verwendung: Offene oder zusammengeführte PRs anzeigen.
bb_get_pr : Ruft PR-Details ab ( workspaceSlug : str req, repoSlug : str req, prId : str req). Verwendung: PR-Details mit Unterschieden anzeigen.
bb_ls_pr_comments : Listet PR-Kommentare auf ( workspaceSlug : str req, repoSlug : str req, prId : str req). Verwendung: PR-Diskussionen anzeigen.
bb_add_pr_comment : Fügt einen Kommentar zum PR hinzu ( workspaceSlug : str req, repoSlug : str req, prId : str req, content : str req, inline : obj opt). Verwendung: Feedback zu PRs hinzufügen.
bb_add_pr : Erstellt einen PR ( workspaceSlug : str req, repoSlug : str req, title : str req, sourceBranch : str req, targetBranch : str opt). Verwendung: Neue PRs erstellen.
bb_add_branch : Erstellt einen Zweig ( workspaceSlug : str req, repoSlug : str req, newBranchName : str req, sourceBranchOrCommit : str opt). Verwendung: Erstellt einen Feature-Zweig.
bb_clone_repo : Klont ein Repository ( workspaceSlug : str req, repoSlug : str req, targetPath : str req). Verwendung: Code lokal klonen.
bb_get_commit_history : Ruft den Commit-Verlauf ab ( workspaceSlug : str req, repoSlug : str req, revision : str opt, path : str opt). Verwendung: Codeverlauf anzeigen.
bb_get_file : Ruft den Dateiinhalt ab ( workspaceSlug : str req, repoSlug : str req, filePath : str req, revision : str opt). Verwendung: Bestimmte Datei anzeigen.
bb_diff_branches : Zeigt Unterschiede zwischen Zweigen an ( workspaceSlug : str req, repoSlug : str req, sourceBranch : str req, targetBranch : str req). Verwendung: Zweige vergleichen.
bb_diff_commits : Zeigt Unterschiede zwischen Commits an ( workspaceSlug : str req, repoSlug : str req, sourceCommit : str req, targetCommit : str req). Verwendung: Commits vergleichen.
bb_list_branches : Listet Zweige auf ( workspaceSlug : str req, repoSlug : str req, query : str opt, sort : str opt). Verwendung: Alle Zweige anzeigen.

`bb_ls_workspaces`

Alle Arbeitsbereiche auflisten:

{}

Arbeitsbereiche durchsuchen:

{ "query": "devteam" }

`bb_get_workspace`

Arbeitsbereichsdetails abrufen:

{ "workspaceSlug": "acme-corp" }

`bb_ls_repos`

Repos im Arbeitsbereich auflisten:

{ "workspaceSlug": "acme-corp", "projectKey": "PROJ" }

Repos mit Standardarbeitsbereich auflisten:

{ "projectKey": "PROJ" }

`bb_get_repo`

Repository-Details abrufen:

{ "workspaceSlug": "acme-corp", "repoSlug": "backend-api" }

`bb_search`

Suchcode:

{
	"workspaceSlug": "acme-corp",
	"query": "Logger",
	"scope": "code",
	"language": "typescript"
}

`bb_ls_prs`

Liste offener PRs:

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "state": "OPEN" }

`bb_get_pr`

PR-Details erhalten:

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

`bb_ls_pr_comments`

PR-Kommentare auflisten:

{ "workspaceSlug": "acme-corp", "repoSlug": "frontend-app", "prId": "42" }

`bb_add_pr_comment`

Allgemeiner Kommentar hinzufügen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"prId": "42",
	"content": "Looks good."
}

Inline-Kommentar hinzufügen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"prId": "42",
	"content": "Consider refactoring.",
	"inline": { "path": "src/utils.js", "line": 42 }
}

`bb_add_pr`

Pull Request erstellen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"title": "Add login screen",
	"sourceBranch": "feature/login"
}

`bb_add_branch`

Neuen Zweig erstellen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"newBranchName": "feature/new-feature",
	"sourceBranchOrCommit": "main"
}

`bb_clone_repo`

Repository klonen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"targetPath": "/Users/me/projects"
}

`bb_get_commit_history`

Commit-Verlauf anzeigen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api"
}

Gefilterter Commit-Verlauf:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"revision": "develop",
	"path": "src/main/java/com/acme/service/UserService.java"
}

`bb_get_file`

Dateiinhalt abrufen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "backend-api",
	"filePath": "src/main/java/com/acme/service/Application.java",
	"revision": "main"
}

`bb_diff_branches`

Branchen vergleichen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "web-app",
	"sourceBranch": "develop",
	"targetBranch": "main"
}

`bb_diff_commits`

Commits vergleichen:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "web-app",
	"sourceCommit": "a1b2c3d",
	"targetCommit": "e4f5g6h"
}

`bb_list_branches`

Alle Zweige auflisten:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app"
}

Gefilterte Zweige:

{
	"workspaceSlug": "acme-corp",
	"repoSlug": "frontend-app",
	"query": "feature/",
	"sort": "name"
}

CLI-Befehle

CLI-Befehle verwenden kebab-case . Führen Sie --help aus, um Details zu erhalten (z. B. mcp-atlassian-bitbucket ls-workspaces --help ).

ls-workspaces : Listet Arbeitsbereiche auf ( --query ). Beispiel: mcp-atlassian-bitbucket ls-workspaces .
get-workspace : Ruft Arbeitsbereichsdetails ab ( --workspace-slug ). Beispiel: mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp .
ls-repos : Listet Repos auf ( --workspace-slug , --project-key , --query ). Beispiel: mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp .
get-repo : Ruft Repo-Details ab ( --workspace-slug , --repo-slug ). Beispiel: mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api .
search : Durchsucht Code ( --workspace-slug , --query , --scope , --language ). Beispiel: mcp-atlassian-bitbucket search --workspace-slug acme-corp --query "auth" .
ls-prs : Listet PRs auf ( --workspace-slug , --repo-slug , --state ). Beispiel: mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api .
get-pr : Ruft PR-Details ab ( --workspace-slug , --repo-slug , --pr-id ). Beispiel: mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 .
ls-pr-comments : Listet PR-Kommentare auf ( --workspace-slug , --repo-slug , --pr-id ). Beispiel: mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 .
add-pr-comment : Fügt einen PR-Kommentar hinzu ( --workspace-slug , --repo-slug , --pr-id , --content ). Beispiel: mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 --content "Looks good" .
add-pr : Erstellt PR ( --workspace-slug , --repo-slug , --title , --source-branch ). Beispiel: mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug backend-api --title "New feature" --source-branch feature/login .
get-file : Ruft den Dateiinhalt ab ( --workspace-slug , --repo-slug , --file-path ). Beispiel: mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path src/main.js .
add-branch : Erstellt einen Zweig ( --workspace-slug , --repo-slug , --new-branch-name ). Beispiel: mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug backend-api --new-branch-name feature/new .

Auflisten und Anzeigen von Arbeitsbereichen/Repositorys

# List all workspaces
mcp-atlassian-bitbucket ls-workspaces

# Get details of a specific workspace
mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp

# List repositories in a workspace
mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ

# Get details of a specific repository
mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api

Arbeiten mit Pull Requests

# List open pull requests in a repository
mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN

# Get details of a specific pull request with code changes
mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42

# List comments on a pull request
mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42

# Add a comment to a pull request
mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content "Looks good to merge."

# Create a new pull request
mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title "Add login screen" --source-branch feature/login

Code und Commits

# Search for code
mcp-atlassian-bitbucket search --workspace-slug acme-corp --query "Logger" --scope code --language typescript

# View commit history
mcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop

# Get file content
mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path "src/Application.java" --revision main

# Compare branches
mcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main

# Compare commits
mcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h

Filialleitung

# List branches
mcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query "feature/" --sort name

# Create a new branch
mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main

# Clone a repository
mcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects

Antwortformat

Alle Antworten sind im Markdown-Format, einschließlich:

Titel : Durchgeführte Operation oder angezeigte Entität.
Kontext : Arbeitsbereich, Repository, Pull-Anfrage oder Zweiginformationen.
Inhalt : Primärdaten wie Dateiinhalte, PR-Details oder Suchergebnisse.
Metadaten : Zeitstempel, Autoren und Statistiken.
Unterschiede : Codeänderungen mit Syntaxhervorhebung für Unterschiede zwischen Zweigen/Commits.

Repository-Details

# Repository: backend-api

**Workspace:** acme-corp
**Full Name:** acme-corp/backend-api
**Language:** Java
**Created:** 2024-01-15 by John Smith
**Updated:** 2025-05-10 (2 days ago)

## Overview
Spring Boot backend API for the ACME product suite.

## Statistics
- **Default Branch:** main
- **Size:** 24.5 MB
- **Commits:** 358
- **Open PRs:** 4
- **Forks:** 3

## Recent Activity
- PR #42: "Add OAuth2 support" by Jane Doe (Open)
- PR #41: "Fix pagination bug" by Alex Kim (Merged)
- PR #40: "Update dependencies" by John Smith (Merged)

*Repository URL: https://bitbucket.org/acme-corp/backend-api*

Pull Request-Überprüfung

# Pull Request #42: Add OAuth2 support

**Repository:** acme-corp/backend-api
**Author:** Jane Doe
**State:** OPEN
**Created:** 2025-05-15 (4 days ago)
**Updated:** 2025-05-18 (yesterday)

## Description
Implements OAuth2 authentication flow with support for:
- Authorization code grant
- Refresh tokens
- Token caching

## Changes
- **Files changed:** 7
- **Additions:** 245 lines
- **Deletions:** 32 lines

## Diff for src/auth/OAuthService.java


	@@ -10,6 +10,25 @@ public class OAuthService {
		private final TokenRepository tokenRepository;
		private final HttpClient httpClient;
	
	+    @Autowired
	+    public OAuthService(
	+            TokenRepository tokenRepository,
	+            HttpClient httpClient) {
	+        this.tokenRepository = tokenRepository;
	+        this.httpClient = httpClient;
	+    }
	+
	+    public TokenResponse refreshToken(String refreshToken) {
	+        // Validate refresh token
	+        if (StringUtils.isEmpty(refreshToken)) {
	+            throw new InvalidTokenException("Refresh token cannot be empty");
	+        }
	+        
	+        // Call OAuth server for new access token
	+        return httpClient.post("/oauth/token")
	+            .body(Map.of("grant_type", "refresh_token", "refresh_token", refreshToken))
	+            .execute()
	+            .as(TokenResponse.class);
	+    }

## Comments (3)
1. **John Smith** (2 days ago):
   > Please add unit tests for the refresh token flow

2. **Jane Doe** (yesterday):
   > Added tests in the latest commit

3. **Approval by:** Alex Kim (yesterday)

*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*

Entwicklung

# Clone repository
git clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git
cd mcp-server-atlassian-bitbucket

# Install dependencies
npm install

# Run in development mode
npm run dev:server

# Run tests
npm test

Beitragen

Beiträge sind willkommen! Bitte:

Forken Sie das Repository.
Erstellen Sie einen Feature-Zweig ( git checkout -b feature/xyz ).
Änderungen festschreiben ( git commit -m "Add xyz feature" ).
Pushen Sie zum Zweig ( git push origin feature/xyz ).
Öffnen Sie eine Pull-Anfrage.

Weitere Einzelheiten finden Sie unter CONTRIBUTING.md .

Lizenz

ISC-Lizenz

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Ein Integrationstool, das KI-Assistenten wie Claude den direkten Zugriff auf Bitbucket-Repositorys, Pull Requests und Code sowie die Interaktion mit diesen ermöglicht, ohne dass Kopier-/Einfügevorgänge erforderlich sind.

Related MCP Servers

GitHub MCP Server
Jehan26
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.
Last updated -
0
GitHub MCP Tools
NZenitram
-
security
F
license
-
quality
A Multi-Claude Program for interacting with GitHub APIs through Claude Desktop, allowing users to search repositories, manage issues, pull requests, repository settings, workflows, and collaborators.
Last updated -
1
GitHub MCP Server
shibdad
-
security
A
license
-
quality
Connects Claude Desktop to GitHub repositories, enabling users to perform git operations and GitHub API interactions through natural conversation.
Last updated -
1,400
MIT License
GitHub MCP Tools
Pranesh-2005
-
security
F
license
-
quality
A set of tools allowing AI assistants to interact directly with GitHub, enabling automation of tasks like fetching user profiles, creating repositories, and managing pull requests.
Last updated -

View all related MCP servers

Atlassian Bitbucket MCP Server

Warum diesen Server verwenden?

Was ist MCP?

Voraussetzungen

Aufstellen

Schritt 1: Authentifizieren

Option A: Bitbucket-App-Passwort (empfohlen)

Option B: Atlassian API Token

Schritt 2: Anmeldeinformationen konfigurieren

Option A: MCP-Konfigurationsdatei (empfohlen)

Option B: Umgebungsvariablen

Schritt 3: Installieren und Ausführen

Schnellstart mit npx

Globale Installation

Schritt 4: Mit dem AI Assistant verbinden

MCP-Werkzeuge

bb_ls_workspaces

bb_get_workspace

bb_ls_repos

bb_get_repo

bb_search

bb_ls_prs

bb_get_pr

bb_ls_pr_comments

bb_add_pr_comment

bb_add_pr

bb_add_branch

bb_clone_repo

bb_get_commit_history

bb_get_file

bb_diff_branches

bb_diff_commits

bb_list_branches