[{"_1":2,"_514":-5,"_515":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_400":401},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",7058884,"membership","referenceId","01971406-43e3-74e8-b880-2f000258007a","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_81":-5,"_82":40,"_29":83,"_318":319,"_399":229},"availableLocales",[28,40,46,53,60,67,74],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","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.","name","Atlassian Bitbucket MCP Server","readme","# Atlassian Bitbucket MCP Server\n\nEin 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.\n\n[![NPM-Version](https://img.shields.io/npm/v/@aashari/mcp-server-atlassian-bitbucket)](https://www.npmjs.com/package/@aashari/mcp-server-atlassian-bitbucket) [![Build-Status](https://img.shields.io/github/workflow/status/aashari/mcp-server-atlassian-bitbucket/CI)](https://github.com/aashari/mcp-server-atlassian-bitbucket/actions)\n\n## Warum diesen Server verwenden?\n\n* **Minimaler Input, maximaler Output** : Einfache Kennungen liefern umfassende Details, ohne dass zusätzliche Flags erforderlich sind.\n* **Umfangreiche Code-Visualisierung** : Erhalten Sie detaillierte Einblicke in Codeänderungen mit Dateistatistiken, Diff-Ansichten und intelligentem Kontext.\n* **Sichere lokale Authentifizierung** : Führen Sie die Authentifizierung lokal mit Ihren Anmeldeinformationen aus und speichern Sie Token niemals auf Remote-Servern.\n* **Intuitive Markdown-Antworten** : Gut strukturierte, konsistente Markdown-Formatierung für alle Ausgaben.\n* **Vollständige Bitbucket-Integration** : Zugriff auf Arbeitsbereiche, Repositories, Pull-Anfragen, Kommentare, Codesuche und mehr.\n\n## Was ist MCP?\n\nModel 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.\n\n## Voraussetzungen\n\n* **Node.js** (>=18.x): [Herunterladen](https://nodejs.org/)\n* **Bitbucket Cloud-Konto**\n\n## Aufstellen\n\n### Schritt 1: Authentifizieren\n\nWählen Sie eine der folgenden Authentifizierungsmethoden:\n\n#### Option A: Bitbucket-App-Passwort (empfohlen)\n\nGenerieren Sie eines aus [Bitbucket App Passwords](https://bitbucket.org/account/settings/app-passwords/) . Mindestberechtigungen:\n\n* Arbeitsbereiche: Lesen\n* Repositories: Lesen\n* Pull Requests: Lesen\n\nSie können auch `BITBUCKET_DEFAULT_WORKSPACE` festlegen, um einen Standardarbeitsbereich anzugeben, wenn dieser nicht explizit angegeben ist.\n\n#### Option B: Atlassian API Token\n\nGenerieren Sie eines aus [Atlassian API-Tokens](https://id.atlassian.com/manage-profile/security/api-tokens) .\n\n**Hinweis:** Es werden dringend Bitbucket-App-Passwörter empfohlen, da sie detailliertere, Bitbucket-spezifische Berechtigungen bieten.\n\n### Schritt 2: Anmeldeinformationen konfigurieren\n\n#### Option A: MCP-Konfigurationsdatei (empfohlen)\n\nBearbeiten oder erstellen Sie `~/.mcp/configs.json` :\n\n**Verwenden des Bitbucket-App-Passworts:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_BITBUCKET_USERNAME\": \"\",\n\t\t\t\"ATLASSIAN_BITBUCKET_APP_PASSWORD\": \"\"\n\t\t}\n\t}\n}\n```\n\n**Verwenden des Atlassian API-Tokens:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"bitbucket\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\"\n\t\t}\n\t}\n}\n```\n\n#### Option B: Umgebungsvariablen\n\n```bash\nexport ATLASSIAN_BITBUCKET_USERNAME=\"\"\nexport ATLASSIAN_BITBUCKET_APP_PASSWORD=\"\"\n```\n\n### Schritt 3: Installieren und Ausführen\n\n#### Schnellstart mit `npx`\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces\n```\n\n#### Globale Installation\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-bitbucket\nmcp-atlassian-bitbucket ls-workspaces\n```\n\n### Schritt 4: Mit dem AI Assistant verbinden\n\nKonfigurieren Sie Ihren MCP-kompatiblen Client (z. B. Claude, Cursor AI):\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"bitbucket\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-bitbucket\"]\n\t\t}\n\t}\n}\n```\n\n## MCP-Werkzeuge\n\nMCP-Tools verwenden `snake_case` -Namen, `camelCase` -Parameter und geben Antworten im Markdown-Format zurück.\n\n* **bb\\_ls\\_workspaces** : Listet verfügbare Arbeitsbereiche auf ( `query` : str opt). Verwendung: Verfügbare Arbeitsbereiche anzeigen.\n* **bb\\_get\\_workspace** : Ruft Arbeitsbereichsdetails ab ( `workspaceSlug` : str req). Verwendung: Arbeitsbereichsinformationen anzeigen.\n* **bb\\_ls\\_repos** : Listet Repositories auf ( `workspaceSlug` : str opt, `projectKey` : str opt, `query` : str opt, `role` : str opt). Verwendung: Repositories suchen.\n* **bb\\_get\\_repo** : Ruft Repository-Details ab ( `workspaceSlug` : str req, `repoSlug` : str req). Verwendung: Zugriff auf Repository-Informationen.\n* **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.\n* **bb\\_ls\\_prs** : Listet Pull Requests auf ( `workspaceSlug` : str req, `repoSlug` : str req, `state` : str opt). Verwendung: Offene oder zusammengeführte PRs anzeigen.\n* **bb\\_get\\_pr** : Ruft PR-Details ab ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req). Verwendung: PR-Details mit Unterschieden anzeigen.\n* **bb\\_ls\\_pr\\_comments** : Listet PR-Kommentare auf ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req). Verwendung: PR-Diskussionen anzeigen.\n* **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.\n* **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.\n* **bb\\_add\\_branch** : Erstellt einen Zweig ( `workspaceSlug` : str req, `repoSlug` : str req, `newBranchName` : str req, `sourceBranchOrCommit` : str opt). Verwendung: Erstellt einen Feature-Zweig.\n* **bb\\_clone\\_repo** : Klont ein Repository ( `workspaceSlug` : str req, `repoSlug` : str req, `targetPath` : str req). Verwendung: Code lokal klonen.\n* **bb\\_get\\_commit\\_history** : Ruft den Commit-Verlauf ab ( `workspaceSlug` : str req, `repoSlug` : str req, `revision` : str opt, `path` : str opt). Verwendung: Codeverlauf anzeigen.\n* **bb\\_get\\_file** : Ruft den Dateiinhalt ab ( `workspaceSlug` : str req, `repoSlug` : str req, `filePath` : str req, `revision` : str opt). Verwendung: Bestimmte Datei anzeigen.\n* **bb\\_diff\\_branches** : Zeigt Unterschiede zwischen Zweigen an ( `workspaceSlug` : str req, `repoSlug` : str req, `sourceBranch` : str req, `targetBranch` : str req). Verwendung: Zweige vergleichen.\n* **bb\\_diff\\_commits** : Zeigt Unterschiede zwischen Commits an ( `workspaceSlug` : str req, `repoSlug` : str req, `sourceCommit` : str req, `targetCommit` : str req). Verwendung: Commits vergleichen.\n* **bb\\_list\\_branches** : Listet Zweige auf ( `workspaceSlug` : str req, `repoSlug` : str req, `query` : str opt, `sort` : str opt). Verwendung: Alle Zweige anzeigen.\n\n### `bb_ls_workspaces`\n\n**Alle Arbeitsbereiche auflisten:**\n\n```json\n{}\n```\n\n**Arbeitsbereiche durchsuchen:**\n\n```json\n{ \"query\": \"devteam\" }\n```\n\n### `bb_get_workspace`\n\n**Arbeitsbereichsdetails abrufen:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\" }\n```\n\n### `bb_ls_repos`\n\n**Repos im Arbeitsbereich auflisten:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"projectKey\": \"PROJ\" }\n```\n\n**Repos mit Standardarbeitsbereich auflisten:**\n\n```json\n{ \"projectKey\": \"PROJ\" }\n```\n\n### `bb_get_repo`\n\n**Repository-Details abrufen:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"backend-api\" }\n```\n\n### `bb_search`\n\n**Suchcode:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"query\": \"Logger\",\n\t\"scope\": \"code\",\n\t\"language\": \"typescript\"\n}\n```\n\n### `bb_ls_prs`\n\n**Liste offener PRs:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"state\": \"OPEN\" }\n```\n\n### `bb_get_pr`\n\n**PR-Details erhalten:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_ls_pr_comments`\n\n**PR-Kommentare auflisten:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_add_pr_comment`\n\n**Allgemeiner Kommentar hinzufügen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Looks good.\"\n}\n```\n\n**Inline-Kommentar hinzufügen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Consider refactoring.\",\n\t\"inline\": { \"path\": \"src/utils.js\", \"line\": 42 }\n}\n```\n\n### `bb_add_pr`\n\n**Pull Request erstellen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"title\": \"Add login screen\",\n\t\"sourceBranch\": \"feature/login\"\n}\n```\n\n### `bb_add_branch`\n\n**Neuen Zweig erstellen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"newBranchName\": \"feature/new-feature\",\n\t\"sourceBranchOrCommit\": \"main\"\n}\n```\n\n### `bb_clone_repo`\n\n**Repository klonen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"targetPath\": \"/Users/me/projects\"\n}\n```\n\n### `bb_get_commit_history`\n\n**Commit-Verlauf anzeigen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\"\n}\n```\n\n**Gefilterter Commit-Verlauf:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"revision\": \"develop\",\n\t\"path\": \"src/main/java/com/acme/service/UserService.java\"\n}\n```\n\n### `bb_get_file`\n\n**Dateiinhalt abrufen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"filePath\": \"src/main/java/com/acme/service/Application.java\",\n\t\"revision\": \"main\"\n}\n```\n\n### `bb_diff_branches`\n\n**Branchen vergleichen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceBranch\": \"develop\",\n\t\"targetBranch\": \"main\"\n}\n```\n\n### `bb_diff_commits`\n\n**Commits vergleichen:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceCommit\": \"a1b2c3d\",\n\t\"targetCommit\": \"e4f5g6h\"\n}\n```\n\n### `bb_list_branches`\n\n**Alle Zweige auflisten:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\"\n}\n```\n\n**Gefilterte Zweige:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"query\": \"feature/\",\n\t\"sort\": \"name\"\n}\n```\n\n## CLI-Befehle\n\nCLI-Befehle verwenden `kebab-case` . Führen Sie `--help` aus, um Details zu erhalten (z. B. `mcp-atlassian-bitbucket ls-workspaces --help` ).\n\n* **ls-workspaces** : Listet Arbeitsbereiche auf ( `--query` ). Beispiel: `mcp-atlassian-bitbucket ls-workspaces` .\n* **get-workspace** : Ruft Arbeitsbereichsdetails ab ( `--workspace-slug` ). Beispiel: `mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp` .\n* **ls-repos** : Listet Repos auf ( `--workspace-slug` , `--project-key` , `--query` ). Beispiel: `mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp` .\n* **get-repo** : Ruft Repo-Details ab ( `--workspace-slug` , `--repo-slug` ). Beispiel: `mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api` .\n* **search** : Durchsucht Code ( `--workspace-slug` , `--query` , `--scope` , `--language` ). Beispiel: `mcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"auth\"` .\n* **ls-prs** : Listet PRs auf ( `--workspace-slug` , `--repo-slug` , `--state` ). Beispiel: `mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api` .\n* **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` .\n* **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` .\n* **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\"` .\n* **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` .\n* **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` .\n* **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` .\n\n### Auflisten und Anzeigen von Arbeitsbereichen/Repositorys\n\n```bash\n# List all workspaces\nmcp-atlassian-bitbucket ls-workspaces\n\n# Get details of a specific workspace\nmcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp\n\n# List repositories in a workspace\nmcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ\n\n# Get details of a specific repository\nmcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api\n```\n\n### Arbeiten mit Pull Requests\n\n```bash\n# List open pull requests in a repository\nmcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN\n\n# Get details of a specific pull request with code changes\nmcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# List comments on a pull request\nmcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# Add a comment to a pull request\nmcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content \"Looks good to merge.\"\n\n# Create a new pull request\nmcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title \"Add login screen\" --source-branch feature/login\n```\n\n### Code und Commits\n\n```bash\n# Search for code\nmcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"Logger\" --scope code --language typescript\n\n# View commit history\nmcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop\n\n# Get file content\nmcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path \"src/Application.java\" --revision main\n\n# Compare branches\nmcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main\n\n# Compare commits\nmcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h\n```\n\n### Filialleitung\n\n```bash\n# List branches\nmcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query \"feature/\" --sort name\n\n# Create a new branch\nmcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main\n\n# Clone a repository\nmcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects\n```\n\n## Antwortformat\n\nAlle Antworten sind im Markdown-Format, einschließlich:\n\n* **Titel** : Durchgeführte Operation oder angezeigte Entität.\n* **Kontext** : Arbeitsbereich, Repository, Pull-Anfrage oder Zweiginformationen.\n* **Inhalt** : Primärdaten wie Dateiinhalte, PR-Details oder Suchergebnisse.\n* **Metadaten** : Zeitstempel, Autoren und Statistiken.\n* **Unterschiede** : Codeänderungen mit Syntaxhervorhebung für Unterschiede zwischen Zweigen/Commits.\n\n### Repository-Details\n\n```markdown\n# Repository: backend-api\n\n**Workspace:** acme-corp\n**Full Name:** acme-corp/backend-api\n**Language:** Java\n**Created:** 2024-01-15 by John Smith\n**Updated:** 2025-05-10 (2 days ago)\n\n## Overview\nSpring Boot backend API for the ACME product suite.\n\n## Statistics\n- **Default Branch:** main\n- **Size:** 24.5 MB\n- **Commits:** 358\n- **Open PRs:** 4\n- **Forks:** 3\n\n## Recent Activity\n- PR #42: \"Add OAuth2 support\" by Jane Doe (Open)\n- PR #41: \"Fix pagination bug\" by Alex Kim (Merged)\n- PR #40: \"Update dependencies\" by John Smith (Merged)\n\n*Repository URL: https://bitbucket.org/acme-corp/backend-api*\n```\n\n### Pull Request-Überprüfung\n\n```markdown\n# Pull Request #42: Add OAuth2 support\n\n**Repository:** acme-corp/backend-api\n**Author:** Jane Doe\n**State:** OPEN\n**Created:** 2025-05-15 (4 days ago)\n**Updated:** 2025-05-18 (yesterday)\n\n## Description\nImplements OAuth2 authentication flow with support for:\n- Authorization code grant\n- Refresh tokens\n- Token caching\n\n## Changes\n- **Files changed:** 7\n- **Additions:** 245 lines\n- **Deletions:** 32 lines\n\n## Diff for src/auth/OAuthService.java\n\n\n\t@@ -10,6 +10,25 @@ public class OAuthService {\n\t\tprivate final TokenRepository tokenRepository;\n\t\tprivate final HttpClient httpClient;\n\t\n\t+ @Autowired\n\t+ public OAuthService(\n\t+ TokenRepository tokenRepository,\n\t+ HttpClient httpClient) {\n\t+ this.tokenRepository = tokenRepository;\n\t+ this.httpClient = httpClient;\n\t+ }\n\t+\n\t+ public TokenResponse refreshToken(String refreshToken) {\n\t+ // Validate refresh token\n\t+ if (StringUtils.isEmpty(refreshToken)) {\n\t+ throw new InvalidTokenException(\"Refresh token cannot be empty\");\n\t+ }\n\t+ \n\t+ // Call OAuth server for new access token\n\t+ return httpClient.post(\"/oauth/token\")\n\t+ .body(Map.of(\"grant_type\", \"refresh_token\", \"refresh_token\", refreshToken))\n\t+ .execute()\n\t+ .as(TokenResponse.class);\n\t+ }\n\n## Comments (3)\n1. **John Smith** (2 days ago):\n > Please add unit tests for the refresh token flow\n\n2. **Jane Doe** (yesterday):\n > Added tests in the latest commit\n\n3. **Approval by:** Alex Kim (yesterday)\n\n*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*\n```\n\n## Entwicklung\n\n```bash\n# Clone repository\ngit clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git\ncd mcp-server-atlassian-bitbucket\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev:server\n\n# Run tests\nnpm test\n```\n\n## Beitragen\n\nBeiträge sind willkommen! Bitte:\n\n1. Forken Sie das Repository.\n2. Erstellen Sie einen Feature-Zweig ( `git checkout -b feature/xyz` ).\n3. Änderungen festschreiben ( `git commit -m \"Add xyz feature\"` ).\n4. Pushen Sie zum Zweig ( `git push origin feature/xyz` ).\n5. Öffnen Sie eine Pull-Anfrage.\n\nWeitere Einzelheiten finden Sie unter [CONTRIBUTING.md](CONTRIBUTING.md) .\n\n## Lizenz\n\n[ISC-Lizenz](LICENSE)","German","tag","de-DE",{"_29":41,"_33":44,"_38":45},{"_31":42,"_33":34,"_35":43},"An integration tool that enables AI assistants like Claude to directly access and interact with Bitbucket repositories, pull requests, and code without requiring copy/paste operations.","# Atlassian Bitbucket MCP Server\n\nA Node.js/TypeScript Model Context Protocol (MCP) server for Atlassian Bitbucket Cloud. Enables AI systems (e.g., LLMs like Claude or Cursor AI) to securely interact with your repositories, pull requests, workspaces, and code in real time.\n\n[![NPM Version](https://img.shields.io/npm/v/@aashari/mcp-server-atlassian-bitbucket)](https://www.npmjs.com/package/@aashari/mcp-server-atlassian-bitbucket)\n[![Build Status](https://img.shields.io/github/workflow/status/aashari/mcp-server-atlassian-bitbucket/CI)](https://github.com/aashari/mcp-server-atlassian-bitbucket/actions)\n\n## Why Use This Server?\n\n- **Minimal Input, Maximum Output**: Simple identifiers provide comprehensive details without requiring extra flags.\n- **Rich Code Visualization**: Get detailed insights into code changes with file statistics, diff views, and smart context.\n- **Secure Local Authentication**: Run locally with your credentials, never storing tokens on remote servers.\n- **Intuitive Markdown Responses**: Well-structured, consistent Markdown formatting for all outputs.\n- **Full Bitbucket Integration**: Access workspaces, repositories, pull requests, comments, code search, and more.\n\n## What is MCP?\n\nModel Context Protocol (MCP) is an open standard for securely connecting AI systems to external tools and data sources. This server implements MCP for Bitbucket Cloud, enabling AI assistants to interact with your Bitbucket data programmatically.\n\n## Prerequisites\n\n- **Node.js** (>=18.x): [Download](https://nodejs.org/)\n- **Bitbucket Cloud Account**\n\n## Setup\n\n### Step 1: Authenticate\n\nChoose one of the following authentication methods:\n\n#### Option A: Bitbucket App Password (Recommended)\n\nGenerate one from [Bitbucket App Passwords](https://bitbucket.org/account/settings/app-passwords/). Minimum permissions:\n- Workspaces: Read\n- Repositories: Read\n- Pull Requests: Read\n\nYou can also set `BITBUCKET_DEFAULT_WORKSPACE` to specify a default workspace when not explicitly provided.\n\n#### Option B: Atlassian API Token\n\nGenerate one from [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens).\n\n**Note:** Bitbucket App Passwords are strongly recommended as they provide more granular, Bitbucket-specific permissions.\n\n### Step 2: Configure Credentials\n\n#### Option A: MCP Config File (Recommended)\n\nEdit or create `~/.mcp/configs.json`:\n\n**Using Bitbucket App Password:**\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_BITBUCKET_USERNAME\": \"\",\n\t\t\t\"ATLASSIAN_BITBUCKET_APP_PASSWORD\": \"\"\n\t\t}\n\t}\n}\n```\n\n**Using Atlassian API Token:**\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"bitbucket\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\"\n\t\t}\n\t}\n}\n```\n\n#### Option B: Environment Variables\n\n```bash\nexport ATLASSIAN_BITBUCKET_USERNAME=\"\"\nexport ATLASSIAN_BITBUCKET_APP_PASSWORD=\"\"\n```\n\n### Step 3: Install and Run\n\n#### Quick Start with `npx`\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces\n```\n\n#### Global Installation\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-bitbucket\nmcp-atlassian-bitbucket ls-workspaces\n```\n\n### Step 4: Connect to AI Assistant\n\nConfigure your MCP-compatible client (e.g., Claude, Cursor AI):\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"bitbucket\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-bitbucket\"]\n\t\t}\n\t}\n}\n```\n\n## MCP Tools\n\nMCP tools use `snake_case` names, `camelCase` parameters, and return Markdown-formatted responses.\n\n- **bb_ls_workspaces**: Lists available workspaces (`query`: str opt). Use: View accessible workspaces.\n- **bb_get_workspace**: Gets workspace details (`workspaceSlug`: str req). Use: View workspace information.\n- **bb_ls_repos**: Lists repositories (`workspaceSlug`: str opt, `projectKey`: str opt, `query`: str opt, `role`: str opt). Use: Find repositories.\n- **bb_get_repo**: Gets repository details (`workspaceSlug`: str req, `repoSlug`: str req). Use: Access repo information.\n- **bb_search**: Searches Bitbucket content (`workspaceSlug`: str req, `query`: str req, `scope`: str opt, `language`: str opt, `extension`: str opt). Use: Find code or PRs.\n- **bb_ls_prs**: Lists pull requests (`workspaceSlug`: str req, `repoSlug`: str req, `state`: str opt). Use: View open or merged PRs.\n- **bb_get_pr**: Gets PR details (`workspaceSlug`: str req, `repoSlug`: str req, `prId`: str req). Use: View PR details with diffs.\n- **bb_ls_pr_comments**: Lists PR comments (`workspaceSlug`: str req, `repoSlug`: str req, `prId`: str req). Use: View PR discussions.\n- **bb_add_pr_comment**: Adds comment to PR (`workspaceSlug`: str req, `repoSlug`: str req, `prId`: str req, `content`: str req, `inline`: obj opt). Use: Add feedback to PRs.\n- **bb_add_pr**: Creates a PR (`workspaceSlug`: str req, `repoSlug`: str req, `title`: str req, `sourceBranch`: str req, `targetBranch`: str opt). Use: Create new PRs.\n- **bb_add_branch**: Creates a branch (`workspaceSlug`: str req, `repoSlug`: str req, `newBranchName`: str req, `sourceBranchOrCommit`: str opt). Use: Create a feature branch.\n- **bb_clone_repo**: Clones a repository (`workspaceSlug`: str req, `repoSlug`: str req, `targetPath`: str req). Use: Clone code locally.\n- **bb_get_commit_history**: Gets commit history (`workspaceSlug`: str req, `repoSlug`: str req, `revision`: str opt, `path`: str opt). Use: View code history.\n- **bb_get_file**: Gets file content (`workspaceSlug`: str req, `repoSlug`: str req, `filePath`: str req, `revision`: str opt). Use: View specific file.\n- **bb_diff_branches**: Shows diff between branches (`workspaceSlug`: str req, `repoSlug`: str req, `sourceBranch`: str req, `targetBranch`: str req). Use: Compare branches.\n- **bb_diff_commits**: Shows diff between commits (`workspaceSlug`: str req, `repoSlug`: str req, `sourceCommit`: str req, `targetCommit`: str req). Use: Compare commits.\n- **bb_list_branches**: Lists branches (`workspaceSlug`: str req, `repoSlug`: str req, `query`: str opt, `sort`: str opt). Use: View all branches.\n\n

MCP Tool Examples (Click to expand)

\n\n### `bb_ls_workspaces`\n\n**List All Workspaces:**\n```json\n{}\n```\n\n**Search Workspaces:**\n```json\n{ \"query\": \"devteam\" }\n```\n\n### `bb_get_workspace`\n\n**Get Workspace Details:**\n```json\n{ \"workspaceSlug\": \"acme-corp\" }\n```\n\n### `bb_ls_repos`\n\n**List Repos in Workspace:**\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"projectKey\": \"PROJ\" }\n```\n\n**List Repos Using Default Workspace:**\n```json\n{ \"projectKey\": \"PROJ\" }\n```\n\n### `bb_get_repo`\n\n**Get Repository Details:**\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"backend-api\" }\n```\n\n### `bb_search`\n\n**Search Code:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"query\": \"Logger\",\n\t\"scope\": \"code\",\n\t\"language\": \"typescript\"\n}\n```\n\n### `bb_ls_prs`\n\n**List Open PRs:**\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"state\": \"OPEN\" }\n```\n\n### `bb_get_pr`\n\n**Get PR Details:**\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_ls_pr_comments`\n\n**List PR Comments:**\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_add_pr_comment`\n\n**Add General Comment:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Looks good.\"\n}\n```\n\n**Add Inline Comment:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Consider refactoring.\",\n\t\"inline\": { \"path\": \"src/utils.js\", \"line\": 42 }\n}\n```\n\n### `bb_add_pr`\n\n**Create Pull Request:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"title\": \"Add login screen\",\n\t\"sourceBranch\": \"feature/login\"\n}\n```\n\n### `bb_add_branch`\n\n**Create New Branch:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"newBranchName\": \"feature/new-feature\",\n\t\"sourceBranchOrCommit\": \"main\"\n}\n```\n\n### `bb_clone_repo`\n\n**Clone Repository:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"targetPath\": \"/Users/me/projects\"\n}\n```\n\n### `bb_get_commit_history`\n\n**View Commit History:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\"\n}\n```\n\n**Filtered Commit History:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"revision\": \"develop\",\n\t\"path\": \"src/main/java/com/acme/service/UserService.java\"\n}\n```\n\n### `bb_get_file`\n\n**Get File Content:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"filePath\": \"src/main/java/com/acme/service/Application.java\",\n\t\"revision\": \"main\"\n}\n```\n\n### `bb_diff_branches`\n\n**Compare Branches:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceBranch\": \"develop\",\n\t\"targetBranch\": \"main\"\n}\n```\n\n### `bb_diff_commits`\n\n**Compare Commits:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceCommit\": \"a1b2c3d\",\n\t\"targetCommit\": \"e4f5g6h\"\n}\n```\n\n### `bb_list_branches`\n\n**List All Branches:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\"\n}\n```\n\n**Filtered Branches:**\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"query\": \"feature/\",\n\t\"sort\": \"name\"\n}\n```\n\n

\n\n## CLI Commands\n\nCLI commands use `kebab-case`. Run `--help` for details (e.g., `mcp-atlassian-bitbucket ls-workspaces --help`).\n\n- **ls-workspaces**: Lists workspaces (`--query`). Ex: `mcp-atlassian-bitbucket ls-workspaces`.\n- **get-workspace**: Gets workspace details (`--workspace-slug`). Ex: `mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp`.\n- **ls-repos**: Lists repos (`--workspace-slug`, `--project-key`, `--query`). Ex: `mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp`.\n- **get-repo**: Gets repo details (`--workspace-slug`, `--repo-slug`). Ex: `mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api`.\n- **search**: Searches code (`--workspace-slug`, `--query`, `--scope`, `--language`). Ex: `mcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"auth\"`.\n- **ls-prs**: Lists PRs (`--workspace-slug`, `--repo-slug`, `--state`). Ex: `mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api`.\n- **get-pr**: Gets PR details (`--workspace-slug`, `--repo-slug`, `--pr-id`). Ex: `mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug backend-api --pr-id 42`.\n- **ls-pr-comments**: Lists PR comments (`--workspace-slug`, `--repo-slug`, `--pr-id`). Ex: `mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug backend-api --pr-id 42`.\n- **add-pr-comment**: Adds PR comment (`--workspace-slug`, `--repo-slug`, `--pr-id`, `--content`). Ex: `mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 --content \"Looks good\"`.\n- **add-pr**: Creates PR (`--workspace-slug`, `--repo-slug`, `--title`, `--source-branch`). Ex: `mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug backend-api --title \"New feature\" --source-branch feature/login`.\n- **get-file**: Gets file content (`--workspace-slug`, `--repo-slug`, `--file-path`). Ex: `mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path src/main.js`.\n- **add-branch**: Creates branch (`--workspace-slug`, `--repo-slug`, `--new-branch-name`). Ex: `mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug backend-api --new-branch-name feature/new`.\n\n

CLI Command Examples (Click to expand)

\n\n### List and View Workspaces/Repos\n\n```bash\n# List all workspaces\nmcp-atlassian-bitbucket ls-workspaces\n\n# Get details of a specific workspace\nmcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp\n\n# List repositories in a workspace\nmcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ\n\n# Get details of a specific repository\nmcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api\n```\n\n### Working with Pull Requests\n\n```bash\n# List open pull requests in a repository\nmcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN\n\n# Get details of a specific pull request with code changes\nmcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# List comments on a pull request\nmcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# Add a comment to a pull request\nmcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content \"Looks good to merge.\"\n\n# Create a new pull request\nmcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title \"Add login screen\" --source-branch feature/login\n```\n\n### Code and Commits\n\n```bash\n# Search for code\nmcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"Logger\" --scope code --language typescript\n\n# View commit history\nmcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop\n\n# Get file content\nmcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path \"src/Application.java\" --revision main\n\n# Compare branches\nmcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main\n\n# Compare commits\nmcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h\n```\n\n### Branch Management\n\n```bash\n# List branches\nmcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query \"feature/\" --sort name\n\n# Create a new branch\nmcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main\n\n# Clone a repository\nmcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects\n```\n\n

\n\n## Response Format\n\nAll responses are Markdown-formatted, including:\n\n- **Title**: Operation performed or entity viewed.\n- **Context**: Workspace, repository, pull request, or branch information.\n- **Content**: Primary data such as file content, PR details, or search results.\n- **Metadata**: Timestamps, authors, and statistics.\n- **Diffs**: Code changes with syntax highlighting for diffs between branches/commits.\n\n

Response Format Examples (Click to expand)

\n\n### Repository Details\n\n```markdown\n# Repository: backend-api\n\n**Workspace:** acme-corp\n**Full Name:** acme-corp/backend-api\n**Language:** Java\n**Created:** 2024-01-15 by John Smith\n**Updated:** 2025-05-10 (2 days ago)\n\n## Overview\nSpring Boot backend API for the ACME product suite.\n\n## Statistics\n- **Default Branch:** main\n- **Size:** 24.5 MB\n- **Commits:** 358\n- **Open PRs:** 4\n- **Forks:** 3\n\n## Recent Activity\n- PR #42: \"Add OAuth2 support\" by Jane Doe (Open)\n- PR #41: \"Fix pagination bug\" by Alex Kim (Merged)\n- PR #40: \"Update dependencies\" by John Smith (Merged)\n\n*Repository URL: https://bitbucket.org/acme-corp/backend-api*\n```\n\n### Pull Request Review\n\n```markdown\n# Pull Request #42: Add OAuth2 support\n\n**Repository:** acme-corp/backend-api\n**Author:** Jane Doe\n**State:** OPEN\n**Created:** 2025-05-15 (4 days ago)\n**Updated:** 2025-05-18 (yesterday)\n\n## Description\nImplements OAuth2 authentication flow with support for:\n- Authorization code grant\n- Refresh tokens\n- Token caching\n\n## Changes\n- **Files changed:** 7\n- **Additions:** 245 lines\n- **Deletions:** 32 lines\n\n## Diff for src/auth/OAuthService.java\n\n\n\t@@ -10,6 +10,25 @@ public class OAuthService {\n\t\tprivate final TokenRepository tokenRepository;\n\t\tprivate final HttpClient httpClient;\n\t\n\t+ @Autowired\n\t+ public OAuthService(\n\t+ TokenRepository tokenRepository,\n\t+ HttpClient httpClient) {\n\t+ this.tokenRepository = tokenRepository;\n\t+ this.httpClient = httpClient;\n\t+ }\n\t+\n\t+ public TokenResponse refreshToken(String refreshToken) {\n\t+ // Validate refresh token\n\t+ if (StringUtils.isEmpty(refreshToken)) {\n\t+ throw new InvalidTokenException(\"Refresh token cannot be empty\");\n\t+ }\n\t+ \n\t+ // Call OAuth server for new access token\n\t+ return httpClient.post(\"/oauth/token\")\n\t+ .body(Map.of(\"grant_type\", \"refresh_token\", \"refresh_token\", refreshToken))\n\t+ .execute()\n\t+ .as(TokenResponse.class);\n\t+ }\n\n## Comments (3)\n1. **John Smith** (2 days ago):\n > Please add unit tests for the refresh token flow\n\n2. **Jane Doe** (yesterday):\n > Added tests in the latest commit\n\n3. **Approval by:** Alex Kim (yesterday)\n\n*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*\n```\n\n

\n\n## Development\n\n```bash\n# Clone repository\ngit clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git\ncd mcp-server-atlassian-bitbucket\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev:server\n\n# Run tests\nnpm test\n```\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository.\n2. Create a feature branch (`git checkout -b feature/xyz`).\n3. Commit changes (`git commit -m \"Add xyz feature\"`).\n4. Push to the branch (`git push origin feature/xyz`).\n5. Open a pull request.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## License\n\n[ISC License](LICENSE)\n","English","en-US",{"_29":47,"_33":51,"_38":52},{"_31":48,"_33":49,"_35":50},"Una herramienta de integración que permite a los asistentes de IA como Claude acceder e interactuar directamente con repositorios de Bitbucket, solicitudes de extracción y código sin necesidad de operaciones de copiar y pegar.","Servidor MCP de Atlassian Bitbucket","# Servidor MCP de Atlassian Bitbucket\n\nUn servidor de Protocolo de Contexto de Modelo (MCP) Node.js/TypeScript para Atlassian Bitbucket Cloud. Permite que los sistemas de IA (p. ej., LLM como Claude o Cursor AI) interactúen de forma segura con sus repositorios, solicitudes de extracción, espacios de trabajo y código en tiempo real.\n\n[![Versión NPM](https://img.shields.io/npm/v/@aashari/mcp-server-atlassian-bitbucket)](https://www.npmjs.com/package/@aashari/mcp-server-atlassian-bitbucket) [![Estado de compilación](https://img.shields.io/github/workflow/status/aashari/mcp-server-atlassian-bitbucket/CI)](https://github.com/aashari/mcp-server-atlassian-bitbucket/actions)\n\n## ¿Por qué utilizar este servidor?\n\n* **Entrada mínima, salida máxima** : los identificadores simples proporcionan detalles completos sin necesidad de indicadores adicionales.\n* **Visualización de código enriquecido** : obtenga información detallada sobre los cambios de código con estadísticas de archivos, vistas de diferencias y contexto inteligente.\n* **Autenticación local segura** : ejecútela localmente con sus credenciales y nunca almacene tokens en servidores remotos.\n* **Respuestas intuitivas de Markdown** : formato de Markdown consistente y bien estructurado para todas las salidas.\n* **Integración completa con Bitbucket** : acceda a espacios de trabajo, repositorios, solicitudes de extracción, comentarios, búsqueda de código y más.\n\n## ¿Qué es MCP?\n\nEl Protocolo de Contexto de Modelo (MCP) es un estándar abierto para conectar de forma segura sistemas de IA a herramientas y fuentes de datos externas. Este servidor implementa MCP para Bitbucket Cloud, lo que permite que los asistentes de IA interactúen con sus datos de Bitbucket mediante programación.\n\n## Prerrequisitos\n\n* **Node.js** (>=18.x): [Descargar](https://nodejs.org/)\n* **Cuenta en la nube de Bitbucket**\n\n## Configuración\n\n### Paso 1: Autenticar\n\nElija uno de los siguientes métodos de autenticación:\n\n#### Opción A: Contraseña de la aplicación Bitbucket (recomendada)\n\nGenera una desde [las contraseñas de la aplicación Bitbucket](https://bitbucket.org/account/settings/app-passwords/) . Permisos mínimos:\n\n* Espacios de trabajo: Leer\n* Repositorios: Leer\n* Solicitudes de extracción: lectura\n\nTambién puede configurar `BITBUCKET_DEFAULT_WORKSPACE` para especificar un espacio de trabajo predeterminado cuando no se proporciona explícitamente.\n\n#### Opción B: Token de API de Atlassian\n\nGenere uno a partir de [tokens API de Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) .\n\n**Nota:** Se recomienda encarecidamente utilizar contraseñas de aplicaciones Bitbucket, ya que proporcionan permisos más granulares y específicos de Bitbucket.\n\n### Paso 2: Configurar credenciales\n\n#### Opción A: Archivo de configuración MCP (recomendado)\n\nEditar o crear `~/.mcp/configs.json` :\n\n**Usando la contraseña de la aplicación Bitbucket:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_BITBUCKET_USERNAME\": \"\",\n\t\t\t\"ATLASSIAN_BITBUCKET_APP_PASSWORD\": \"\"\n\t\t}\n\t}\n}\n```\n\n**Uso del token API de Atlassian:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"bitbucket\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\"\n\t\t}\n\t}\n}\n```\n\n#### Opción B: Variables de entorno\n\n```bash\nexport ATLASSIAN_BITBUCKET_USERNAME=\"\"\nexport ATLASSIAN_BITBUCKET_APP_PASSWORD=\"\"\n```\n\n### Paso 3: Instalar y ejecutar\n\n#### Inicio rápido con `npx`\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces\n```\n\n#### Instalación global\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-bitbucket\nmcp-atlassian-bitbucket ls-workspaces\n```\n\n### Paso 4: Conéctese al Asistente de IA\n\nConfigure su cliente compatible con MCP (por ejemplo, Claude, Cursor AI):\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"bitbucket\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-bitbucket\"]\n\t\t}\n\t}\n}\n```\n\n## Herramientas MCP\n\nLas herramientas MCP utilizan nombres `snake_case` , parámetros `camelCase` y devuelven respuestas con formato Markdown.\n\n* **bb\\_ls\\_workspaces** : Enumera los espacios de trabajo disponibles ( `query` : str opt). Uso: Ver espacios de trabajo accesibles.\n* **bb\\_get\\_workspace** : Obtiene detalles del espacio de trabajo ( `workspaceSlug` : str req). Uso: Ver información del espacio de trabajo.\n* **bb\\_ls\\_repos** : Lista los repositorios ( `workspaceSlug` : str opt, `projectKey` : str opt, `query` : str opt, `role` : str opt). Uso: Buscar repositorios.\n* **bb\\_get\\_repo** : Obtiene los detalles del repositorio ( `workspaceSlug` : str req, `repoSlug` : str req). Uso: Accede a la información del repositorio.\n* **bb\\_search** : Busca contenido de Bitbucket ( `workspaceSlug` : str req, `query` : str req, `scope` : str opt, `language` : str opt, `extension` : str opt). Uso: Buscar código o solicitudes de solicitud (PR).\n* **bb\\_ls\\_prs** : Lista las solicitudes de extracción ( `workspaceSlug` : str req, `repoSlug` : str req, `state` : str opt). Uso: Ver solicitudes de extracción abiertas o fusionadas.\n* **bb\\_get\\_pr** : Obtiene los detalles de la solicitud de retorno ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req). Uso: Ver detalles de la solicitud de retorno con diferencias.\n* **bb\\_ls\\_pr\\_comments** : Lista los comentarios de la solicitud de relaciones públicas ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req). Uso: Ver las discusiones de la solicitud de relaciones públicas.\n* **bb\\_add\\_pr\\_comment** : Agrega un comentario a la solicitud de relaciones públicas ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req, `content` : str req, `inline` : obj opt). Uso: Agrega comentarios a las solicitudes de relaciones públicas.\n* **bb\\_add\\_pr** : Crea una solicitud de solicitud ( `workspaceSlug` : str req, `repoSlug` : str req, `title` : str req, `sourceBranch` : str req, `targetBranch` : str opt). Uso: Crea nuevas solicitudes de solicitud.\n* **bb\\_add\\_branch** : Crea una rama ( `workspaceSlug` : str req, `repoSlug` : str req, `newBranchName` : str req, `sourceBranchOrCommit` : str opt). Uso: Crea una rama de funciones.\n* **bb\\_clone\\_repo** : Clona un repositorio ( `workspaceSlug` : str req, `repoSlug` : str req, `targetPath` : str req). Uso: Clona código localmente.\n* **bb\\_get\\_commit\\_history** : Obtiene el historial de confirmaciones ( `workspaceSlug` : str req, `repoSlug` : str req, `revision` : str opt, `path` : str opt). Uso: Ver el historial de código.\n* **bb\\_get\\_file** : Obtiene el contenido del archivo ( `workspaceSlug` : str req, `repoSlug` : str req, `filePath` : str req, `revision` : str opt). Uso: Ver archivo específico.\n* **bb\\_diff\\_branches** : Muestra la diferencia entre ramas ( `workspaceSlug` : str req, `repoSlug` : str req, `sourceBranch` : str req, `targetBranch` : str req). Uso: Compara ramas.\n* **bb\\_diff\\_commits** : Muestra la diferencia entre confirmaciones ( `workspaceSlug` : str req, `repoSlug` : str req, `sourceCommit` : str req, `targetCommit` : str req). Uso: Comparar confirmaciones.\n* **bb\\_list\\_branches** : Lista las ramas ( `workspaceSlug` : str req, `repoSlug` : str req, `query` : str opt, `sort` : str opt). Uso: Ver todas las ramas.\n\n### `bb_ls_workspaces`\n\n**Listar todos los espacios de trabajo:**\n\n```json\n{}\n```\n\n**Buscar espacios de trabajo:**\n\n```json\n{ \"query\": \"devteam\" }\n```\n\n### `bb_get_workspace`\n\n**Obtener detalles del espacio de trabajo:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\" }\n```\n\n### `bb_ls_repos`\n\n**Lista de repositorios en el espacio de trabajo:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"projectKey\": \"PROJ\" }\n```\n\n**Lista de repositorios que utilizan el espacio de trabajo predeterminado:**\n\n```json\n{ \"projectKey\": \"PROJ\" }\n```\n\n### `bb_get_repo`\n\n**Obtener detalles del repositorio:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"backend-api\" }\n```\n\n### `bb_search`\n\n**Código de búsqueda:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"query\": \"Logger\",\n\t\"scope\": \"code\",\n\t\"language\": \"typescript\"\n}\n```\n\n### `bb_ls_prs`\n\n**Lista de PR abiertas:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"state\": \"OPEN\" }\n```\n\n### `bb_get_pr`\n\n**Obtenga detalles de relaciones públicas:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_ls_pr_comments`\n\n**Lista de comentarios de relaciones públicas:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_add_pr_comment`\n\n**Añadir comentario general:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Looks good.\"\n}\n```\n\n**Agregar comentario en línea:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Consider refactoring.\",\n\t\"inline\": { \"path\": \"src/utils.js\", \"line\": 42 }\n}\n```\n\n### `bb_add_pr`\n\n**Crear solicitud de extracción:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"title\": \"Add login screen\",\n\t\"sourceBranch\": \"feature/login\"\n}\n```\n\n### `bb_add_branch`\n\n**Crear nueva rama:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"newBranchName\": \"feature/new-feature\",\n\t\"sourceBranchOrCommit\": \"main\"\n}\n```\n\n### `bb_clone_repo`\n\n**Repositorio de clones:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"targetPath\": \"/Users/me/projects\"\n}\n```\n\n### `bb_get_commit_history`\n\n**Ver historial de confirmaciones:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\"\n}\n```\n\n**Historial de confirmaciones filtrado:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"revision\": \"develop\",\n\t\"path\": \"src/main/java/com/acme/service/UserService.java\"\n}\n```\n\n### `bb_get_file`\n\n**Obtener el contenido del archivo:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"filePath\": \"src/main/java/com/acme/service/Application.java\",\n\t\"revision\": \"main\"\n}\n```\n\n### `bb_diff_branches`\n\n**Comparar sucursales:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceBranch\": \"develop\",\n\t\"targetBranch\": \"main\"\n}\n```\n\n### `bb_diff_commits`\n\n**Comparar confirmaciones:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceCommit\": \"a1b2c3d\",\n\t\"targetCommit\": \"e4f5g6h\"\n}\n```\n\n### `bb_list_branches`\n\n**Listar todas las sucursales:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\"\n}\n```\n\n**Ramas filtradas:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"query\": \"feature/\",\n\t\"sort\": \"name\"\n}\n```\n\n## Comandos CLI\n\nLos comandos CLI usan `kebab-case` . Ejecute `--help` para obtener más información (p. ej., `mcp-atlassian-bitbucket ls-workspaces --help` ).\n\n* **ls-workspaces** : Enumera los espacios de trabajo ( `--query` ). Ejemplo: `mcp-atlassian-bitbucket ls-workspaces` .\n* **get-workspace** : Obtiene los detalles del espacio de trabajo ( `--workspace-slug` ). Ejemplo: `mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp` .\n* **ls-repos** : Lista los repositorios ( `--workspace-slug` , `--project-key` , `--query` ). Ejemplo: `mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp` .\n* **get-repo** : Obtiene los detalles del repositorio ( `--workspace-slug` , `--repo-slug` ). Ejemplo: `mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api` .\n* **búsqueda** : Busca código ( `--workspace-slug` , `--query` , `--scope` , `--language` ). Ejemplo: `mcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"auth\"` .\n* **ls-prs** : Enumera las solicitudes de solicitud ( `--workspace-slug` , `--repo-slug` , `--state` ). Ejemplo: `mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api` .\n* **get-pr** : Obtiene los detalles de la solicitud de registro ( `--workspace-slug` , `--repo-slug` , `--pr-id` ). Ejemplo: `mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` .\n* **ls-pr-comments** : Lista los comentarios de PR ( `--workspace-slug` , `--repo-slug` , `--pr-id` ). Ejemplo: `mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` .\n* **add-pr-comment** : Añade un comentario de PR ( `--workspace-slug` , `--repo-slug` , `--pr-id` , `--content` ). Ejemplo: `mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 --content \"Looks good\"` .\n* **add-pr** : Crea una solicitud de registro ( `--workspace-slug` , `--repo-slug` , `--title` , `--source-branch` ). Ejemplo: `mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug backend-api --title \"New feature\" --source-branch feature/login` .\n* **get-file** : Obtiene el contenido del archivo ( `--workspace-slug` , `--repo-slug` , `--file-path` ). Ejemplo: `mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path src/main.js` .\n* **add-branch** : Crea una rama ( `--workspace-slug` , `--repo-slug` , `--new-branch-name` ). Ejemplo: `mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug backend-api --new-branch-name feature/new` .\n\n### Listar y ver espacios de trabajo/repositorios\n\n```bash\n# List all workspaces\nmcp-atlassian-bitbucket ls-workspaces\n\n# Get details of a specific workspace\nmcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp\n\n# List repositories in a workspace\nmcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ\n\n# Get details of a specific repository\nmcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api\n```\n\n### Trabajar con solicitudes de extracción\n\n```bash\n# List open pull requests in a repository\nmcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN\n\n# Get details of a specific pull request with code changes\nmcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# List comments on a pull request\nmcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# Add a comment to a pull request\nmcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content \"Looks good to merge.\"\n\n# Create a new pull request\nmcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title \"Add login screen\" --source-branch feature/login\n```\n\n### Código y confirmaciones\n\n```bash\n# Search for code\nmcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"Logger\" --scope code --language typescript\n\n# View commit history\nmcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop\n\n# Get file content\nmcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path \"src/Application.java\" --revision main\n\n# Compare branches\nmcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main\n\n# Compare commits\nmcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h\n```\n\n### Gestión de sucursales\n\n```bash\n# List branches\nmcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query \"feature/\" --sort name\n\n# Create a new branch\nmcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main\n\n# Clone a repository\nmcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects\n```\n\n## Formato de respuesta\n\nTodas las respuestas están en formato Markdown, incluidas:\n\n* **Título** : Operación realizada o entidad visualizada.\n* **Contexto** : espacio de trabajo, repositorio, solicitud de extracción o información de rama.\n* **Contenido** : datos primarios como contenido de archivo, detalles de relaciones públicas o resultados de búsqueda.\n* **Metadatos** : marcas de tiempo, autores y estadísticas.\n* **Diferencias** : cambios de código con resaltado de sintaxis para diferencias entre ramas/confirmaciones.\n\n### Detalles del repositorio\n\n```markdown\n# Repository: backend-api\n\n**Workspace:** acme-corp\n**Full Name:** acme-corp/backend-api\n**Language:** Java\n**Created:** 2024-01-15 by John Smith\n**Updated:** 2025-05-10 (2 days ago)\n\n## Overview\nSpring Boot backend API for the ACME product suite.\n\n## Statistics\n- **Default Branch:** main\n- **Size:** 24.5 MB\n- **Commits:** 358\n- **Open PRs:** 4\n- **Forks:** 3\n\n## Recent Activity\n- PR #42: \"Add OAuth2 support\" by Jane Doe (Open)\n- PR #41: \"Fix pagination bug\" by Alex Kim (Merged)\n- PR #40: \"Update dependencies\" by John Smith (Merged)\n\n*Repository URL: https://bitbucket.org/acme-corp/backend-api*\n```\n\n### Revisión de solicitud de extracción\n\n```markdown\n# Pull Request #42: Add OAuth2 support\n\n**Repository:** acme-corp/backend-api\n**Author:** Jane Doe\n**State:** OPEN\n**Created:** 2025-05-15 (4 days ago)\n**Updated:** 2025-05-18 (yesterday)\n\n## Description\nImplements OAuth2 authentication flow with support for:\n- Authorization code grant\n- Refresh tokens\n- Token caching\n\n## Changes\n- **Files changed:** 7\n- **Additions:** 245 lines\n- **Deletions:** 32 lines\n\n## Diff for src/auth/OAuthService.java\n\n\n\t@@ -10,6 +10,25 @@ public class OAuthService {\n\t\tprivate final TokenRepository tokenRepository;\n\t\tprivate final HttpClient httpClient;\n\t\n\t+ @Autowired\n\t+ public OAuthService(\n\t+ TokenRepository tokenRepository,\n\t+ HttpClient httpClient) {\n\t+ this.tokenRepository = tokenRepository;\n\t+ this.httpClient = httpClient;\n\t+ }\n\t+\n\t+ public TokenResponse refreshToken(String refreshToken) {\n\t+ // Validate refresh token\n\t+ if (StringUtils.isEmpty(refreshToken)) {\n\t+ throw new InvalidTokenException(\"Refresh token cannot be empty\");\n\t+ }\n\t+ \n\t+ // Call OAuth server for new access token\n\t+ return httpClient.post(\"/oauth/token\")\n\t+ .body(Map.of(\"grant_type\", \"refresh_token\", \"refresh_token\", refreshToken))\n\t+ .execute()\n\t+ .as(TokenResponse.class);\n\t+ }\n\n## Comments (3)\n1. **John Smith** (2 days ago):\n > Please add unit tests for the refresh token flow\n\n2. **Jane Doe** (yesterday):\n > Added tests in the latest commit\n\n3. **Approval by:** Alex Kim (yesterday)\n\n*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*\n```\n\n## Desarrollo\n\n```bash\n# Clone repository\ngit clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git\ncd mcp-server-atlassian-bitbucket\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev:server\n\n# Run tests\nnpm test\n```\n\n## Contribuyendo\n\n¡Agradecemos sus contribuciones! Por favor:\n\n1. Bifurcar el repositorio.\n2. Crea una rama de características ( `git checkout -b feature/xyz` ).\n3. Confirmar cambios ( `git commit -m \"Add xyz feature\"` ).\n4. Empujar a la rama ( `git push origin feature/xyz` ).\n5. Abrir una solicitud de extracción.\n\nConsulte [CONTRIBUTING.md](CONTRIBUTING.md) para obtener más detalles.\n\n## Licencia\n\n[Licencia ISC](LICENSE)","Spanish","es-ES",{"_29":54,"_33":58,"_38":59},{"_31":55,"_33":56,"_35":57},"Claude のような AI アシスタントがコピー/貼り付け操作を必要とせずに Bitbucket リポジトリ、プルリクエスト、コードに直接アクセスして操作できるようにする統合ツール。","Atlassian Bitbucket MCP サーバー","# Atlassian Bitbucket MCP サーバー\n\nAtlassian Bitbucket Cloud 用の Node.js/TypeScript Model Context Protocol (MCP) サーバー。AI システム (Claude や Cursor AI などの LLM など) がリポジトリ、プルリクエスト、ワークスペース、コードとリアルタイムかつ安全にやり取りできるようにします。\n\n[![NPMバージョン](https://img.shields.io/npm/v/@aashari/mcp-server-atlassian-bitbucket)](https://www.npmjs.com/package/@aashari/mcp-server-atlassian-bitbucket) [![ビルドステータス](https://img.shields.io/github/workflow/status/aashari/mcp-server-atlassian-bitbucket/CI)](https://github.com/aashari/mcp-server-atlassian-bitbucket/actions)\n\n## このサーバーを使用する理由\n\n* **最小限の入力、最大限の出力**: シンプルな識別子により、追加のフラグを必要とせずに包括的な詳細が提供されます。\n* **豊富なコードの視覚化**: ファイル統計、差分ビュー、スマートコンテキストを使用して、コードの変更に関する詳細な情報を取得します。\n* **安全なローカル認証**: 資格情報を使用してローカルで実行し、トークンをリモートサーバーに保存することはありません。\n* **直感的な Markdown 応答**: すべての出力に対して、適切に構造化された一貫した Markdown 形式が採用されています。\n* **完全な Bitbucket 統合**: ワークスペース、リポジトリ、プルリクエスト、コメント、コード検索などにアクセスできます。\n\n## MCPとは何ですか?\n\nモデルコンテキストプロトコル（MCP）は、AIシステムを外部ツールやデータソースに安全に接続するためのオープンスタンダードです。このサーバーはBitbucket Cloud向けにMCPを実装しており、AIアシスタントがBitbucketデータをプログラムで操作できるようにします。\n\n## 前提条件\n\n* **Node.js** (>=18.x):[ダウンロード](https://nodejs.org/)\n* **Bitbucket クラウドアカウント**\n\n## 設定\n\n### ステップ1: 認証\n\n次のいずれかの認証方法を選択します。\n\n#### オプション A: Bitbucket アプリのパスワード (推奨)\n\n[Bitbucket App Passwords](https://bitbucket.org/account/settings/app-passwords/)から生成します。最小権限：\n\n* ワークスペース: 読み取り\n* リポジトリ: 読む\n* プルリクエスト: 読む\n\n明示的に指定されていない場合にデフォルトのワークスペースを指定するには、 `BITBUCKET_DEFAULT_WORKSPACE`を設定することもできます。\n\n#### オプションB: Atlassian APIトークン\n\n[Atlassian API トークン](https://id.atlassian.com/manage-profile/security/api-tokens)から生成します。\n\n**注:** Bitbucket アプリパスワードは、より詳細な Bitbucket 固有の権限を提供するため、強くお勧めします。\n\n### ステップ2: 資格情報を構成する\n\n#### オプション A: MCP 構成ファイル (推奨)\n\n`~/.mcp/configs.json`を編集または作成します。\n\n**Bitbucket アプリパスワードの使用:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_BITBUCKET_USERNAME\": \"\",\n\t\t\t\"ATLASSIAN_BITBUCKET_APP_PASSWORD\": \"\"\n\t\t}\n\t}\n}\n```\n\n**Atlassian API トークンの使用:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"bitbucket\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\"\n\t\t}\n\t}\n}\n```\n\n#### オプションB: 環境変数\n\n```bash\nexport ATLASSIAN_BITBUCKET_USERNAME=\"\"\nexport ATLASSIAN_BITBUCKET_APP_PASSWORD=\"\"\n```\n\n### ステップ3: インストールと実行\n\n#### `npx`のクイックスタート\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces\n```\n\n#### グローバルインストール\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-bitbucket\nmcp-atlassian-bitbucket ls-workspaces\n```\n\n### ステップ4：AIアシスタントに接続する\n\nMCP 互換クライアント (例: Claude、Cursor AI) を構成します。\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"bitbucket\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-bitbucket\"]\n\t\t}\n\t}\n}\n```\n\n## MCPツール\n\nMCP ツールは、 `snake_case`名、 `camelCase`パラメータを使用し、Markdown 形式の応答を返します。\n\n* **bb\\_ls\\_workspaces** : 利用可能なワークスペースを一覧表示します（ `query` ：str opt）。使用方法：アクセス可能なワークスペースを表示します。\n* **bb\\_get\\_workspace** : ワークスペースの詳細を取得します（ `workspaceSlug` : 文字列が必要です）。用途: ワークスペース情報を表示します。\n* **bb\\_ls\\_repos** : リポジトリを一覧表示します ( `workspaceSlug` : str opt、 `projectKey` : str opt、 `query` : str opt、 `role` : str opt)。用途: リポジトリを検索します。\n* **bb\\_get\\_repo** : リポジトリの詳細を取得します（ `workspaceSlug` : 文字列必須、 `repoSlug` : 文字列必須）。用途: リポジトリ情報にアクセスします。\n* **bb\\_search** : Bitbucket コンテンツを検索します ( `workspaceSlug` : str req、 `query` : str req、 `scope` : str opt、 `language` : str opt、 `extension` : str opt)。用途: コードまたは PR を検索します。\n* **bb\\_ls\\_prs** : プルリクエストを一覧表示します（ `workspaceSlug` : str req、 `repoSlug` : str req、 `state` : str opt）。用途: オープンまたはマージされたPRを表示します。\n* **bb\\_get\\_pr** : PRの詳細を取得します（ `workspaceSlug` : 文字列必須、 `repoSlug` : 文字列必須、 `prId` : 文字列必須）。使用方法: 差分を含むPRの詳細を表示します。\n* **bb\\_ls\\_pr\\_comments** : PRコメントを一覧表示します（ `workspaceSlug` : 文字列必須、 `repoSlug` : 文字列必須、 `prId` : 文字列必須）。用途: PRのディスカッションを表示します。\n* **bb\\_add\\_pr\\_comment** : PR にコメントを追加します ( `workspaceSlug` : str req、 `repoSlug` : str req、 `prId` : str req、 `content` : str req、 `inline` : obj opt)。使用方法: PR にフィードバックを追加します。\n* **bb\\_add\\_pr** : PR を作成します ( `workspaceSlug` : str req、 `repoSlug` : str req、 `title` : str req、 `sourceBranch` : str req、 `targetBranch` : str opt)。使用方法: 新しい PR を作成します。\n* **bb\\_add\\_branch** : ブランチを作成します ( `workspaceSlug` : str req、 `repoSlug` : str req、 `newBranchName` : str req、 `sourceBranchOrCommit` : str opt)。使用方法: 機能ブランチを作成します。\n* **bb\\_clone\\_repo** : リポジトリを複製します（ `workspaceSlug` : 文字列必須、 `repoSlug` : 文字列必須、 `targetPath` : 文字列必須）。用途: ローカルでコードを複製します。\n* **bb\\_get\\_commit\\_history** : コミット履歴を取得します（ `workspaceSlug` : str req、 `repoSlug` : str req、 `revision` : str opt、 `path` : str opt）。用途: コード履歴を表示します。\n* **bb\\_get\\_file** : ファイルの内容を取得します（ `workspaceSlug` : str req、 `repoSlug` : str req、 `filePath` : str req、 `revision` : str opt）。使用方法: 特定のファイルを表示します。\n* **bb\\_diff\\_branches** : ブランチ間の差分を表示します（ `workspaceSlug` : str req、 `repoSlug` : str req、 `sourceBranch` : str req、 `targetBranch` : str req）。用途: ブランチを比較します。\n* **bb\\_diff\\_commits** : コミット間の差分を表示します（ `workspaceSlug` : str req、 `repoSlug` : str req、 `sourceCommit` : str req、 `targetCommit` : str req）。用途: コミットを比較します。\n* **bb\\_list\\_branches** : ブランチを一覧表示します ( `workspaceSlug` : str req、 `repoSlug` : str req、 `query` : str opt、 `sort` : str opt)。使用方法: すべてのブランチを表示します。\n\n### `bb_ls_workspaces`\n\n**すべてのワークスペースを一覧表示:**\n\n```json\n{}\n```\n\n**ワークスペースを検索:**\n\n```json\n{ \"query\": \"devteam\" }\n```\n\n### `bb_get_workspace`\n\n**ワークスペースの詳細を取得します:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\" }\n```\n\n### `bb_ls_repos`\n\n**ワークスペース内のリポジトリを一覧表示します:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"projectKey\": \"PROJ\" }\n```\n\n**デフォルトのワークスペースを使用してリポジトリを一覧表示します。**\n\n```json\n{ \"projectKey\": \"PROJ\" }\n```\n\n### `bb_get_repo`\n\n**リポジトリの詳細を取得します:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"backend-api\" }\n```\n\n### `bb_search`\n\n**検索コード:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"query\": \"Logger\",\n\t\"scope\": \"code\",\n\t\"language\": \"typescript\"\n}\n```\n\n### `bb_ls_prs`\n\n**オープン PR をリストします:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"state\": \"OPEN\" }\n```\n\n### `bb_get_pr`\n\n**PRの詳細を取得:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_ls_pr_comments`\n\n**PRコメントをリストする:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_add_pr_comment`\n\n**一般的なコメントを追加:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Looks good.\"\n}\n```\n\n**インラインコメントを追加:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Consider refactoring.\",\n\t\"inline\": { \"path\": \"src/utils.js\", \"line\": 42 }\n}\n```\n\n### `bb_add_pr`\n\n**プルリクエストを作成:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"title\": \"Add login screen\",\n\t\"sourceBranch\": \"feature/login\"\n}\n```\n\n### `bb_add_branch`\n\n**新しいブランチを作成:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"newBranchName\": \"feature/new-feature\",\n\t\"sourceBranchOrCommit\": \"main\"\n}\n```\n\n### `bb_clone_repo`\n\n**クローンリポジトリ:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"targetPath\": \"/Users/me/projects\"\n}\n```\n\n### `bb_get_commit_history`\n\n**コミット履歴を表示:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\"\n}\n```\n\n**フィルタリングされたコミット履歴:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"revision\": \"develop\",\n\t\"path\": \"src/main/java/com/acme/service/UserService.java\"\n}\n```\n\n### `bb_get_file`\n\n**ファイルの内容を取得:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"filePath\": \"src/main/java/com/acme/service/Application.java\",\n\t\"revision\": \"main\"\n}\n```\n\n### `bb_diff_branches`\n\n**ブランチを比較:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceBranch\": \"develop\",\n\t\"targetBranch\": \"main\"\n}\n```\n\n### `bb_diff_commits`\n\n**コミットの比較:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceCommit\": \"a1b2c3d\",\n\t\"targetCommit\": \"e4f5g6h\"\n}\n```\n\n### `bb_list_branches`\n\n**すべてのブランチを一覧表示:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\"\n}\n```\n\n**フィルタリングされたブランチ:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"query\": \"feature/\",\n\t\"sort\": \"name\"\n}\n```\n\n## CLIコマンド\n\nCLIコマンドは`kebab-case`を使用します。詳細については、 `--help`を実行してください（例： `mcp-atlassian-bitbucket ls-workspaces --help` ）。\n\n* **ls-workspaces** : ワークスペースを一覧表示します ( `--query` )。例: `mcp-atlassian-bitbucket ls-workspaces` 。\n* **get-workspace** : ワークスペースの詳細を取得します ( `--workspace-slug` )。例: `mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp` 。\n* **ls-repos** : リポジトリを一覧表示します ( `--workspace-slug` 、 `--project-key` 、 `--query` )。例: `mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp` 。\n* **get-repo** : リポジトリの詳細を取得します ( `--workspace-slug` 、 `--repo-slug` )。例: `mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api` 。\n* **search** : コードを検索します ( `--workspace-slug` 、 `--query` 、 `--scope` 、 `--language` )。例: `mcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"auth\"` 。\n* **ls-prs** : PR を一覧表示します ( `--workspace-slug` 、 `--repo-slug` 、 `--state` )。例: `mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api` 。\n* **get-pr** : PRの詳細を取得します（ `--workspace-slug` 、 `--repo-slug` 、 `--pr-id` ）。例： `mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` 。\n* **ls-pr-comments** : PRコメントを一覧表示します（ `--workspace-slug` 、 `--repo-slug` 、 `--pr-id` ）。例： `mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` 。\n* **add-pr-comment** : PRコメントを追加します（ `--workspace-slug` 、 `--repo-slug` 、 `--pr-id` 、 `--content` ）。例： `mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 --content \"Looks good\"` 。\n* **add-pr** : PR を作成します ( `--workspace-slug` 、 `--repo-slug` 、 `--title` 、 `--source-branch` )。例: `mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug backend-api --title \"New feature\" --source-branch feature/login` 。\n* **get-file** : ファイルの内容を取得します ( `--workspace-slug` 、 `--repo-slug` 、 `--file-path` )。例: `mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path src/main.js` 。\n* **add-branch** : ブランチを作成します ( `--workspace-slug` 、 `--repo-slug` 、 `--new-branch-name` )。例: `mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug backend-api --new-branch-name feature/new` 。\n\n### ワークスペース/リポジトリの一覧と表示\n\n```bash\n# List all workspaces\nmcp-atlassian-bitbucket ls-workspaces\n\n# Get details of a specific workspace\nmcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp\n\n# List repositories in a workspace\nmcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ\n\n# Get details of a specific repository\nmcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api\n```\n\n### プルリクエストの操作\n\n```bash\n# List open pull requests in a repository\nmcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN\n\n# Get details of a specific pull request with code changes\nmcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# List comments on a pull request\nmcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# Add a comment to a pull request\nmcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content \"Looks good to merge.\"\n\n# Create a new pull request\nmcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title \"Add login screen\" --source-branch feature/login\n```\n\n### コードとコミット\n\n```bash\n# Search for code\nmcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"Logger\" --scope code --language typescript\n\n# View commit history\nmcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop\n\n# Get file content\nmcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path \"src/Application.java\" --revision main\n\n# Compare branches\nmcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main\n\n# Compare commits\nmcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h\n```\n\n### 支店管理\n\n```bash\n# List branches\nmcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query \"feature/\" --sort name\n\n# Create a new branch\nmcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main\n\n# Clone a repository\nmcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects\n```\n\n## 応答フォーマット\n\nすべての回答は Markdown 形式です。これには以下が含まれます。\n\n* **タイトル**: 実行された操作または表示されたエンティティ。\n* **コンテキスト**: ワークスペース、リポジトリ、プルリクエスト、またはブランチ情報。\n* **コンテンツ**: ファイルコンテンツ、PR の詳細、検索結果などの主要データ。\n* **メタデータ**: タイムスタンプ、作成者、統計。\n* **差分**: ブランチ/コミット間の差分の構文強調表示によるコード変更。\n\n### リポジトリの詳細\n\n```markdown\n# Repository: backend-api\n\n**Workspace:** acme-corp\n**Full Name:** acme-corp/backend-api\n**Language:** Java\n**Created:** 2024-01-15 by John Smith\n**Updated:** 2025-05-10 (2 days ago)\n\n## Overview\nSpring Boot backend API for the ACME product suite.\n\n## Statistics\n- **Default Branch:** main\n- **Size:** 24.5 MB\n- **Commits:** 358\n- **Open PRs:** 4\n- **Forks:** 3\n\n## Recent Activity\n- PR #42: \"Add OAuth2 support\" by Jane Doe (Open)\n- PR #41: \"Fix pagination bug\" by Alex Kim (Merged)\n- PR #40: \"Update dependencies\" by John Smith (Merged)\n\n*Repository URL: https://bitbucket.org/acme-corp/backend-api*\n```\n\n### プルリクエストのレビュー\n\n```markdown\n# Pull Request #42: Add OAuth2 support\n\n**Repository:** acme-corp/backend-api\n**Author:** Jane Doe\n**State:** OPEN\n**Created:** 2025-05-15 (4 days ago)\n**Updated:** 2025-05-18 (yesterday)\n\n## Description\nImplements OAuth2 authentication flow with support for:\n- Authorization code grant\n- Refresh tokens\n- Token caching\n\n## Changes\n- **Files changed:** 7\n- **Additions:** 245 lines\n- **Deletions:** 32 lines\n\n## Diff for src/auth/OAuthService.java\n\n\n\t@@ -10,6 +10,25 @@ public class OAuthService {\n\t\tprivate final TokenRepository tokenRepository;\n\t\tprivate final HttpClient httpClient;\n\t\n\t+ @Autowired\n\t+ public OAuthService(\n\t+ TokenRepository tokenRepository,\n\t+ HttpClient httpClient) {\n\t+ this.tokenRepository = tokenRepository;\n\t+ this.httpClient = httpClient;\n\t+ }\n\t+\n\t+ public TokenResponse refreshToken(String refreshToken) {\n\t+ // Validate refresh token\n\t+ if (StringUtils.isEmpty(refreshToken)) {\n\t+ throw new InvalidTokenException(\"Refresh token cannot be empty\");\n\t+ }\n\t+ \n\t+ // Call OAuth server for new access token\n\t+ return httpClient.post(\"/oauth/token\")\n\t+ .body(Map.of(\"grant_type\", \"refresh_token\", \"refresh_token\", refreshToken))\n\t+ .execute()\n\t+ .as(TokenResponse.class);\n\t+ }\n\n## Comments (3)\n1. **John Smith** (2 days ago):\n > Please add unit tests for the refresh token flow\n\n2. **Jane Doe** (yesterday):\n > Added tests in the latest commit\n\n3. **Approval by:** Alex Kim (yesterday)\n\n*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*\n```\n\n## 発達\n\n```bash\n# Clone repository\ngit clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git\ncd mcp-server-atlassian-bitbucket\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev:server\n\n# Run tests\nnpm test\n```\n\n## 貢献\n\n貢献を歓迎します！ご協力をお願いします:\n\n1. リポジトリをフォークします。\n2. 機能ブランチを作成します ( `git checkout -b feature/xyz` )。\n3. 変更をコミットします ( `git commit -m \"Add xyz feature\"` )。\n4. ブランチにプッシュします ( `git push origin feature/xyz` )。\n5. プルリクエストを開きます。\n\n詳細については、 [CONTRIBUTING.md を](CONTRIBUTING.md)参照してください。\n\n## ライセンス\n\n[ISCライセンス](LICENSE)","Japanese","ja-JP",{"_29":61,"_33":65,"_38":66},{"_31":62,"_33":63,"_35":64},"Claude와 같은 AI 도우미가 복사/붙여넣기 작업 없이 Bitbucket 저장소, 풀 리퀘스트 및 코드에 직접 액세스하여 상호 작용할 수 있도록 하는 통합 도구입니다.","Atlassian Bitbucket MCP 서버","# Atlassian Bitbucket MCP 서버\n\nAtlassian Bitbucket Cloud용 Node.js/TypeScript 모델 컨텍스트 프로토콜(MCP) 서버입니다. AI 시스템(예: Claude 또는 Cursor AI와 같은 LLM)이 저장소, 풀 리퀘스트, 작업 공간 및 코드와 실시간으로 안전하게 상호 작용할 수 있도록 지원합니다.\n\n[![NPM 버전](https://img.shields.io/npm/v/@aashari/mcp-server-atlassian-bitbucket)](https://www.npmjs.com/package/@aashari/mcp-server-atlassian-bitbucket) [![빌드 상태](https://img.shields.io/github/workflow/status/aashari/mcp-server-atlassian-bitbucket/CI)](https://github.com/aashari/mcp-server-atlassian-bitbucket/actions)\n\n## 왜 이 서버를 사용해야 하나요?\n\n* **최소 입력, 최대 출력** : 간단한 식별자는 추가 플래그가 필요하지 않고 포괄적인 세부 정보를 제공합니다.\n* **풍부한 코드 시각화** : 파일 통계, 차이점 보기, 스마트 컨텍스트를 통해 코드 변경 사항에 대한 자세한 통찰력을 얻으세요.\n* **안전한 로컬 인증** : 자격 증명을 사용하여 로컬에서 실행하고, 원격 서버에 토큰을 저장하지 않습니다.\n* **직관적인 마크다운 응답** : 모든 출력에 대해 잘 구성되고 일관된 마크다운 형식이 적용됩니다.\n* **Bitbucket 전체 통합** : 작업 공간, 저장소, 풀 리퀘스트, 댓글, 코드 검색 등에 액세스하세요.\n\n## MCP란 무엇인가요?\n\n모델 컨텍스트 프로토콜(MCP)은 AI 시스템을 외부 도구 및 데이터 소스에 안전하게 연결하기 위한 개방형 표준입니다. 이 서버는 Bitbucket Cloud용 MCP를 구현하여 AI 어시스턴트가 Bitbucket 데이터와 프로그래밍 방식으로 상호 작용할 수 있도록 지원합니다.\n\n## 필수 조건\n\n* **Node.js** (>=18.x): [다운로드](https://nodejs.org/)\n* **Bitbucket 클라우드 계정**\n\n## 설정\n\n### 1단계: 인증\n\n다음 인증 방법 중 하나를 선택하세요.\n\n#### 옵션 A: Bitbucket 앱 비밀번호(권장)\n\n[Bitbucket 앱 비밀번호](https://bitbucket.org/account/settings/app-passwords/) 에서 생성하세요. 최소 권한:\n\n* 작업 공간: 읽기\n* 저장소: 읽기\n* 풀 리퀘스트: 읽기\n\n명시적으로 제공되지 않은 경우 `BITBUCKET_DEFAULT_WORKSPACE` 설정하여 기본 작업 공간을 지정할 수도 있습니다.\n\n#### 옵션 B: Atlassian API 토큰\n\n[Atlassian API 토큰](https://id.atlassian.com/manage-profile/security/api-tokens) 에서 하나를 생성합니다.\n\n**참고:** Bitbucket 앱 비밀번호는 더욱 세부적이고 Bitbucket 전용 권한을 제공하므로 적극 권장됩니다.\n\n### 2단계: 자격 증명 구성\n\n#### 옵션 A: MCP 구성 파일(권장)\n\n`~/.mcp/configs.json` 편집하거나 생성합니다.\n\n**Bitbucket 앱 비밀번호 사용:**\n\n지엑스피1\n\n**Atlassian API 토큰 사용:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"bitbucket\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\"\n\t\t}\n\t}\n}\n```\n\n#### 옵션 B: 환경 변수\n\n```bash\nexport ATLASSIAN_BITBUCKET_USERNAME=\"\"\nexport ATLASSIAN_BITBUCKET_APP_PASSWORD=\"\"\n```\n\n### 3단계: 설치 및 실행\n\n#### `npx` 로 빠르게 시작하기\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces\n```\n\n#### 글로벌 설치\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-bitbucket\nmcp-atlassian-bitbucket ls-workspaces\n```\n\n### 4단계: AI Assistant에 연결\n\nMCP 호환 클라이언트(예: Claude, Cursor AI)를 구성하세요.\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"bitbucket\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-bitbucket\"]\n\t\t}\n\t}\n}\n```\n\n## MCP 도구\n\nMCP 도구는 `snake_case` 이름과 `camelCase` 매개변수를 사용하고 Markdown 형식의 응답을 반환합니다.\n\n* **bb\\_ls\\_workspaces** : 사용 가능한 작업 공간을 나열합니다( `query` : str opt). 사용: 접근 가능한 작업 공간을 확인합니다.\n* **bb\\_get\\_workspace** : 작업 공간 세부 정보를 가져옵니다( `workspaceSlug` : str 요청). 사용: 작업 공간 정보 보기.\n* **bb\\_ls\\_repos** : 저장소를 나열합니다( `workspaceSlug` : str opt, `projectKey` : str opt, `query` : str opt, `role` : str opt). 사용: 저장소 찾기.\n* **bb\\_get\\_repo** : 저장소 세부 정보를 가져옵니다( `workspaceSlug` : 문자열 요청, `repoSlug` : 문자열 요청). 용도: 저장소 정보에 액세스합니다.\n* **bb\\_search** : Bitbucket 콘텐츠를 검색합니다( `workspaceSlug` : str req, `query` : str req, `scope` : str opt, `language` : str opt, `extension` : str opt). 용도: 코드나 PR 찾기.\n* **bb\\_ls\\_prs** : 풀 리퀘스트를 나열합니다( `workspaceSlug` : str 요청, `repoSlug` : str 요청, `state` : str 선택). 사용: 열려 있거나 병합된 PR을 확인합니다.\n* **bb\\_get\\_pr** : PR 세부 정보를 가져옵니다( `workspaceSlug` : str 요청, `repoSlug` : str 요청, `prId` : str 요청). 사용: diff를 포함한 PR 세부 정보를 확인합니다.\n* **bb\\_ls\\_pr\\_comments** : PR 댓글을 나열합니다( `workspaceSlug` : 문자열 요청, `repoSlug` : 문자열 요청, `prId` : 문자열 요청). 용도: PR 토론 보기.\n* **bb\\_add\\_pr\\_comment** : PR에 주석을 추가합니다( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req, `content` : str req, `inline` : obj opt). 사용: PR에 피드백을 추가합니다.\n* **bb\\_add\\_pr** : PR을 생성합니다( `workspaceSlug` : 문자열 요청, `repoSlug` : 문자열 요청, `title` : 문자열 요청, `sourceBranch` : 문자열 요청, `targetBranch` : 문자열 선택). 사용: 새로운 PR을 생성합니다.\n* **bb\\_add\\_branch** : 브랜치를 생성합니다( `workspaceSlug` : str req, `repoSlug` : str req, `newBranchName` : str req, `sourceBranchOrCommit` : str opt). 사용: 기능 브랜치를 생성합니다.\n* **bb\\_clone\\_repo** : 저장소를 복제합니다( `workspaceSlug` : 문자열 요청, `repoSlug` : 문자열 요청, `targetPath` : 문자열 요청). 사용: 로컬에서 코드를 복제합니다.\n* **bb\\_get\\_commit\\_history** : 커밋 기록을 가져옵니다( `workspaceSlug` : str req, `repoSlug` : str req, `revision` : str opt, `path` : str opt). 용도: 코드 기록 보기.\n* **bb\\_get\\_file** : 파일 내용을 가져옵니다( `workspaceSlug` : 문자열 요청, `repoSlug` : 문자열 요청, `filePath` : 문자열 요청, `revision` : 문자열 선택). 사용: 특정 파일 보기.\n* **bb\\_diff\\_branches** : 브랜치 간 차이점을 표시합니다( `workspaceSlug` : 문자열 요청, `repoSlug` : 문자열 요청, `sourceBranch` : 문자열 요청, `targetBranch` : 문자열 요청). 용도: 브랜치를 비교합니다.\n* **bb\\_diff\\_commits** : 커밋 간의 차이점을 표시합니다( `workspaceSlug` : 문자열 요청, `repoSlug` : 문자열 요청, `sourceCommit` : 문자열 요청, `targetCommit` : 문자열 요청). 용도: 커밋을 비교합니다.\n* **bb\\_list\\_branches** : 브랜치를 나열합니다( `workspaceSlug` : str req, `repoSlug` : str req, `query` : str opt, `sort` : str opt). 용도: 모든 브랜치를 봅니다.\n\n### `bb_ls_workspaces`\n\n**모든 작업 공간 나열:**\n\n```json\n{}\n```\n\n**검색 작업 공간:**\n\n```json\n{ \"query\": \"devteam\" }\n```\n\n### `bb_get_workspace`\n\n**작업 공간 세부 정보 가져오기:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\" }\n```\n\n### `bb_ls_repos`\n\n**작업 공간에 저장소 나열:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"projectKey\": \"PROJ\" }\n```\n\n**기본 작업 공간을 사용하여 저장소 나열:**\n\n```json\n{ \"projectKey\": \"PROJ\" }\n```\n\n### `bb_get_repo`\n\n**저장소 세부 정보 가져오기:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"backend-api\" }\n```\n\n### `bb_search`\n\n**검색 코드:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"query\": \"Logger\",\n\t\"scope\": \"code\",\n\t\"language\": \"typescript\"\n}\n```\n\n### `bb_ls_prs`\n\n**공개 PR 목록:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"state\": \"OPEN\" }\n```\n\n### `bb_get_pr`\n\n**PR 세부 정보 받기:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_ls_pr_comments`\n\n**PR 코멘트 목록:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_add_pr_comment`\n\n**일반적인 의견 추가:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Looks good.\"\n}\n```\n\n**인라인 주석 추가:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Consider refactoring.\",\n\t\"inline\": { \"path\": \"src/utils.js\", \"line\": 42 }\n}\n```\n\n### `bb_add_pr`\n\n**풀 리퀘스트 생성:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"title\": \"Add login screen\",\n\t\"sourceBranch\": \"feature/login\"\n}\n```\n\n### `bb_add_branch`\n\n**새로운 지점 만들기:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"newBranchName\": \"feature/new-feature\",\n\t\"sourceBranchOrCommit\": \"main\"\n}\n```\n\n### `bb_clone_repo`\n\n**복제 저장소:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"targetPath\": \"/Users/me/projects\"\n}\n```\n\n### `bb_get_commit_history`\n\n**커밋 기록 보기:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\"\n}\n```\n\n**필터링된 커밋 기록:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"revision\": \"develop\",\n\t\"path\": \"src/main/java/com/acme/service/UserService.java\"\n}\n```\n\n### `bb_get_file`\n\n**파일 내용 가져오기:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"filePath\": \"src/main/java/com/acme/service/Application.java\",\n\t\"revision\": \"main\"\n}\n```\n\n### `bb_diff_branches`\n\n**지점 비교:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceBranch\": \"develop\",\n\t\"targetBranch\": \"main\"\n}\n```\n\n### `bb_diff_commits`\n\n**커밋 비교:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceCommit\": \"a1b2c3d\",\n\t\"targetCommit\": \"e4f5g6h\"\n}\n```\n\n### `bb_list_branches`\n\n**모든 지점 나열:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\"\n}\n```\n\n**필터링된 브랜치:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"query\": \"feature/\",\n\t\"sort\": \"name\"\n}\n```\n\n## CLI 명령\n\nCLI 명령은 `kebab-case` 사용합니다. 자세한 내용을 보려면 `--help` 실행하세요(예: `mcp-atlassian-bitbucket ls-workspaces --help` ).\n\n* **ls-workspaces** : 작업 공간을 나열합니다( `--query` ). 예: `mcp-atlassian-bitbucket ls-workspaces` .\n* **get-workspace** : 작업 공간 세부 정보를 가져옵니다( `--workspace-slug` ). 예: `mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp` .\n* **ls-repos** : 저장소를 나열합니다( `--workspace-slug` , `--project-key` , `--query` ). 예: `mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp` .\n* **get-repo** : 리포 세부 정보를 가져옵니다( `--workspace-slug` , `--repo-slug` ). 예: `mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api` .\n* **검색** : 코드 검색( `--workspace-slug` , `--query` , `--scope` , `--language` ). 예: `mcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"auth\"` .\n* **ls-prs** : PR을 나열합니다( `--workspace-slug` , `--repo-slug` , `--state` ). 예: `mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api` .\n* **get-pr** : PR 세부 정보를 가져옵니다( `--workspace-slug` , `--repo-slug` , `--pr-id` ). 예: `mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` .\n* **ls-pr-comments** : PR 주석을 나열합니다( `--workspace-slug` , `--repo-slug` , `--pr-id` ). 예: `mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` .\n* **add-pr-comment** : PR 주석을 추가합니다( `--workspace-slug` , `--repo-slug` , `--pr-id` , `--content` ). 예: `mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 --content \"Looks good\"` .\n* **add-pr** : PR을 생성합니다( `--workspace-slug` , `--repo-slug` , `--title` , `--source-branch` ). 예: `mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug backend-api --title \"New feature\" --source-branch feature/login` .\n* **get-file** : 파일 내용을 가져옵니다( `--workspace-slug` , `--repo-slug` , `--file-path` ). 예: `mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path src/main.js` .\n* **add-branch** : 브랜치를 생성합니다( `--workspace-slug` , `--repo-slug` , `--new-branch-name` ). 예: `mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug backend-api --new-branch-name feature/new` .\n\n### 작업 공간/저장소 목록 및 보기\n\n```bash\n# List all workspaces\nmcp-atlassian-bitbucket ls-workspaces\n\n# Get details of a specific workspace\nmcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp\n\n# List repositories in a workspace\nmcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ\n\n# Get details of a specific repository\nmcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api\n```\n\n### 풀 리퀘스트 작업\n\n```bash\n# List open pull requests in a repository\nmcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN\n\n# Get details of a specific pull request with code changes\nmcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# List comments on a pull request\nmcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# Add a comment to a pull request\nmcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content \"Looks good to merge.\"\n\n# Create a new pull request\nmcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title \"Add login screen\" --source-branch feature/login\n```\n\n### 코드 및 커밋\n\n```bash\n# Search for code\nmcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"Logger\" --scope code --language typescript\n\n# View commit history\nmcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop\n\n# Get file content\nmcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path \"src/Application.java\" --revision main\n\n# Compare branches\nmcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main\n\n# Compare commits\nmcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h\n```\n\n### 지점 관리\n\n```bash\n# List branches\nmcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query \"feature/\" --sort name\n\n# Create a new branch\nmcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main\n\n# Clone a repository\nmcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects\n```\n\n## 응답 형식\n\n모든 응답은 다음을 포함하여 Markdown 형식으로 작성됩니다.\n\n* **제목** : 수행된 작업 또는 본 엔터티.\n* **컨텍스트** : 작업 공간, 저장소, 풀 리퀘스트 또는 브랜치 정보.\n* **콘텐츠** : 파일 콘텐츠, PR 세부 정보 또는 검색 결과와 같은 기본 데이터입니다.\n* **메타데이터** : 타임스탬프, 작성자, 통계.\n* **Diffs** : 브랜치/커밋 간 diff에 대한 구문 강조 표시와 함께 코드가 변경됩니다.\n\n### 저장소 세부 정보\n\n```markdown\n# Repository: backend-api\n\n**Workspace:** acme-corp\n**Full Name:** acme-corp/backend-api\n**Language:** Java\n**Created:** 2024-01-15 by John Smith\n**Updated:** 2025-05-10 (2 days ago)\n\n## Overview\nSpring Boot backend API for the ACME product suite.\n\n## Statistics\n- **Default Branch:** main\n- **Size:** 24.5 MB\n- **Commits:** 358\n- **Open PRs:** 4\n- **Forks:** 3\n\n## Recent Activity\n- PR #42: \"Add OAuth2 support\" by Jane Doe (Open)\n- PR #41: \"Fix pagination bug\" by Alex Kim (Merged)\n- PR #40: \"Update dependencies\" by John Smith (Merged)\n\n*Repository URL: https://bitbucket.org/acme-corp/backend-api*\n```\n\n### 풀 리퀘스트 검토\n\n```markdown\n# Pull Request #42: Add OAuth2 support\n\n**Repository:** acme-corp/backend-api\n**Author:** Jane Doe\n**State:** OPEN\n**Created:** 2025-05-15 (4 days ago)\n**Updated:** 2025-05-18 (yesterday)\n\n## Description\nImplements OAuth2 authentication flow with support for:\n- Authorization code grant\n- Refresh tokens\n- Token caching\n\n## Changes\n- **Files changed:** 7\n- **Additions:** 245 lines\n- **Deletions:** 32 lines\n\n## Diff for src/auth/OAuthService.java\n\n\n\t@@ -10,6 +10,25 @@ public class OAuthService {\n\t\tprivate final TokenRepository tokenRepository;\n\t\tprivate final HttpClient httpClient;\n\t\n\t+ @Autowired\n\t+ public OAuthService(\n\t+ TokenRepository tokenRepository,\n\t+ HttpClient httpClient) {\n\t+ this.tokenRepository = tokenRepository;\n\t+ this.httpClient = httpClient;\n\t+ }\n\t+\n\t+ public TokenResponse refreshToken(String refreshToken) {\n\t+ // Validate refresh token\n\t+ if (StringUtils.isEmpty(refreshToken)) {\n\t+ throw new InvalidTokenException(\"Refresh token cannot be empty\");\n\t+ }\n\t+ \n\t+ // Call OAuth server for new access token\n\t+ return httpClient.post(\"/oauth/token\")\n\t+ .body(Map.of(\"grant_type\", \"refresh_token\", \"refresh_token\", refreshToken))\n\t+ .execute()\n\t+ .as(TokenResponse.class);\n\t+ }\n\n## Comments (3)\n1. **John Smith** (2 days ago):\n > Please add unit tests for the refresh token flow\n\n2. **Jane Doe** (yesterday):\n > Added tests in the latest commit\n\n3. **Approval by:** Alex Kim (yesterday)\n\n*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*\n```\n\n## 개발\n\n```bash\n# Clone repository\ngit clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git\ncd mcp-server-atlassian-bitbucket\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev:server\n\n# Run tests\nnpm test\n```\n\n## 기여하다\n\n기여를 환영합니다! 다음 내용을 알려주세요.\n\n1. 저장소를 포크합니다.\n2. 기능 브랜치를 생성합니다( `git checkout -b feature/xyz` ).\n3. 변경 사항 커밋( `git commit -m \"Add xyz feature\"` )\n4. 브랜치에 푸시합니다( `git push origin feature/xyz` ).\n5. 풀 리퀘스트를 엽니다.\n\n자세한 내용은 [CONTRIBUTING.md를](CONTRIBUTING.md) 참조하세요.\n\n## 특허\n\n[ISC 라이센스](LICENSE)","Korean","ko-KR",{"_29":68,"_33":72,"_38":73},{"_31":69,"_33":70,"_35":71},"Инструмент интеграции, который позволяет помощникам на основе искусственного интеллекта, таким как Клод, напрямую получать доступ и взаимодействовать с репозиториями Bitbucket, запросами на извлечение и кодом без необходимости выполнения операций копирования/вставки.","Сервер Atlassian Bitbucket MCP","# Сервер Atlassian Bitbucket MCP\n\nСервер Node.js/TypeScript Model Context Protocol (MCP) для Atlassian Bitbucket Cloud. Позволяет системам ИИ (например, LLM, таким как Claude или Cursor AI) безопасно взаимодействовать с вашими репозиториями, запросами на извлечение, рабочими пространствами и кодом в режиме реального времени.\n\n[![Версия НПМ](https://img.shields.io/npm/v/@aashari/mcp-server-atlassian-bitbucket)](https://www.npmjs.com/package/@aashari/mcp-server-atlassian-bitbucket) [![Статус сборки](https://img.shields.io/github/workflow/status/aashari/mcp-server-atlassian-bitbucket/CI)](https://github.com/aashari/mcp-server-atlassian-bitbucket/actions)\n\n## Зачем использовать этот сервер?\n\n* **Минимальный ввод, максимальный вывод** : простые идентификаторы предоставляют исчерпывающую информацию без необходимости дополнительных флагов.\n* **Расширенная визуализация кода** : получите подробную информацию об изменениях кода с помощью статистики файлов, представлений различий и интеллектуального контекста.\n* **Безопасная локальная аутентификация** : работайте локально с вашими учетными данными, никогда не храня токены на удаленных серверах.\n* **Интуитивно понятные ответы Markdown** : хорошо структурированное, единообразное форматирование Markdown для всех выходных данных.\n* **Полная интеграция с Bitbucket** : доступ к рабочим областям, репозиториям, запросам на извлечение, комментариям, поиску кода и многому другому.\n\n## Что такое МКП?\n\nModel Context Protocol (MCP) — открытый стандарт для безопасного подключения систем ИИ к внешним инструментам и источникам данных. Этот сервер реализует MCP для Bitbucket Cloud, позволяя помощникам ИИ взаимодействовать с вашими данными Bitbucket программным способом.\n\n## Предпосылки\n\n* **Node.js** (>=18.x): [Загрузить](https://nodejs.org/)\n* **Учетная запись облака Bitbucket**\n\n## Настраивать\n\n### Шаг 1: Аутентификация\n\nВыберите один из следующих методов аутентификации:\n\n#### Вариант A: Пароль приложения Bitbucket (рекомендуется)\n\nСгенерируйте один из [Bitbucket App Passwords](https://bitbucket.org/account/settings/app-passwords/) . Минимальные разрешения:\n\n* Рабочие пространства: Читать\n* Репозитории: Читать\n* Запросы на извлечение: Читать\n\nВы также можете задать `BITBUCKET_DEFAULT_WORKSPACE` , чтобы указать рабочее пространство по умолчанию, если оно не указано явно.\n\n#### Вариант B: токен API Atlassian\n\nСгенерируйте его с помощью [токенов API Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) .\n\n**Примечание:** настоятельно рекомендуется использовать пароли приложений Bitbucket, поскольку они обеспечивают более детальные разрешения, специфичные для Bitbucket.\n\n### Шаг 2: Настройте учетные данные\n\n#### Вариант A: Файл конфигурации MCP (рекомендуется)\n\nОтредактируйте или создайте `~/.mcp/configs.json` :\n\n**Использование пароля приложения Bitbucket:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_BITBUCKET_USERNAME\": \"\",\n\t\t\t\"ATLASSIAN_BITBUCKET_APP_PASSWORD\": \"\"\n\t\t}\n\t}\n}\n```\n\n**Использование токена API Atlassian:**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"bitbucket\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\"\n\t\t}\n\t}\n}\n```\n\n#### Вариант B: Переменные среды\n\n```bash\nexport ATLASSIAN_BITBUCKET_USERNAME=\"\"\nexport ATLASSIAN_BITBUCKET_APP_PASSWORD=\"\"\n```\n\n### Шаг 3: Установка и запуск\n\n#### Быстрый старт с `npx`\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces\n```\n\n#### Глобальная установка\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-bitbucket\nmcp-atlassian-bitbucket ls-workspaces\n```\n\n### Шаг 4: Подключитесь к AI Assistant\n\nНастройте MCP-совместимый клиент (например, Claude, Cursor AI):\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"bitbucket\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-bitbucket\"]\n\t\t}\n\t}\n}\n```\n\n## Инструменты МКП\n\nИнструменты MCP используют имена `snake_case` , параметры `camelCase` и возвращают ответы в формате Markdown.\n\n* **bb\\_ls\\_workspaces** : Список доступных рабочих пространств ( `query` : str opt). Использование: Просмотр доступных рабочих пространств.\n* **bb\\_get\\_workspace** : Получает сведения о рабочей области ( `workspaceSlug` : str req). Использование: Просмотр информации о рабочей области.\n* **bb\\_ls\\_repos** : Список репозиториев ( `workspaceSlug` : str opt, `projectKey` : str opt, `query` : str opt, `role` : str opt). Использование: Поиск репозиториев.\n* **bb\\_get\\_repo** : Получает данные репозитория ( `workspaceSlug` : str req, `repoSlug` : str req). Использование: Доступ к информации о репозитории.\n* **bb\\_search** : Поиск содержимого Bitbucket ( `workspaceSlug` : str req, `query` : str req, `scope` : str opt, `language` : str opt, `extension` : str opt). Использование: Поиск кода или PR.\n* **bb\\_ls\\_prs** : Список запросов на извлечение ( `workspaceSlug` : str req, `repoSlug` : str req, `state` : str opt). Использование: Просмотр открытых или объединенных PR.\n* **bb\\_get\\_pr** : Получает сведения о PR ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req). Использование: Просмотр сведений о PR с различиями.\n* **bb\\_ls\\_pr\\_comments** : Список комментариев PR ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req). Использование: Просмотр обсуждений PR.\n* **bb\\_add\\_pr\\_comment** : Добавляет комментарий к PR ( `workspaceSlug` : str req, `repoSlug` : str req, `prId` : str req, `content` : str req, `inline` : obj opt). Использование: Добавить отзыв к PR.\n* **bb\\_add\\_pr** : Создает PR ( `workspaceSlug` : str req, `repoSlug` : str req, `title` : str req, `sourceBranch` : str req, `targetBranch` : str opt). Использование: Создание новых PR.\n* **bb\\_add\\_branch** : Создает ветку ( `workspaceSlug` : str req, `repoSlug` : str req, `newBranchName` : str req, `sourceBranchOrCommit` : str opt). Использование: Создать ветку функции.\n* **bb\\_clone\\_repo** : Клонирует репозиторий ( `workspaceSlug` : str req, `repoSlug` : str req, `targetPath` : str req). Использование: Клонировать код локально.\n* **bb\\_get\\_commit\\_history** : Получает историю коммитов ( `workspaceSlug` : str req, `repoSlug` : str req, `revision` : str opt, `path` : str opt). Использование: Просмотр истории кода.\n* **bb\\_get\\_file** : Получает содержимое файла ( `workspaceSlug` : str req, `repoSlug` : str req, `filePath` : str req, `revision` : str opt). Использование: Просмотр определенного файла.\n* **bb\\_diff\\_branches** : Показывает разницу между ветвями ( `workspaceSlug` : str req, `repoSlug` : str req, `sourceBranch` : str req, `targetBranch` : str req). Использование: Сравнение ветвей.\n* **bb\\_diff\\_commits** : Показывает разницу между коммитами ( `workspaceSlug` : str req, `repoSlug` : str req, `sourceCommit` : str req, `targetCommit` : str req). Использование: Сравнение коммитов.\n* **bb\\_list\\_branches** : Список ветвей ( `workspaceSlug` : str req, `repoSlug` : str req, `query` : str opt, `sort` : str opt). Использование: Просмотр всех ветвей.\n\n### `bb_ls_workspaces`\n\n**Список всех рабочих пространств:**\n\n```json\n{}\n```\n\n**Поиск рабочих пространств:**\n\n```json\n{ \"query\": \"devteam\" }\n```\n\n### `bb_get_workspace`\n\n**Получить сведения о рабочем пространстве:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\" }\n```\n\n### `bb_ls_repos`\n\n**Список репозиториев в рабочей области:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"projectKey\": \"PROJ\" }\n```\n\n**Список репозиториев с использованием рабочего пространства по умолчанию:**\n\n```json\n{ \"projectKey\": \"PROJ\" }\n```\n\n### `bb_get_repo`\n\n**Получить данные репозитория:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"backend-api\" }\n```\n\n### `bb_search`\n\n**Поисковый код:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"query\": \"Logger\",\n\t\"scope\": \"code\",\n\t\"language\": \"typescript\"\n}\n```\n\n### `bb_ls_prs`\n\n**Список открытых PR:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"state\": \"OPEN\" }\n```\n\n### `bb_get_pr`\n\n**Получить PR-подробности:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_ls_pr_comments`\n\n**Список PR-комментариев:**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_add_pr_comment`\n\n**Добавить общий комментарий:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Looks good.\"\n}\n```\n\n**Добавить встроенный комментарий:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Consider refactoring.\",\n\t\"inline\": { \"path\": \"src/utils.js\", \"line\": 42 }\n}\n```\n\n### `bb_add_pr`\n\n**Создать запрос на извлечение:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"title\": \"Add login screen\",\n\t\"sourceBranch\": \"feature/login\"\n}\n```\n\n### `bb_add_branch`\n\n**Создать новую ветку:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"newBranchName\": \"feature/new-feature\",\n\t\"sourceBranchOrCommit\": \"main\"\n}\n```\n\n### `bb_clone_repo`\n\n**Клонировать репозиторий:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"targetPath\": \"/Users/me/projects\"\n}\n```\n\n### `bb_get_commit_history`\n\n**Просмотреть историю коммитов:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\"\n}\n```\n\n**Отфильтрованная история коммитов:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"revision\": \"develop\",\n\t\"path\": \"src/main/java/com/acme/service/UserService.java\"\n}\n```\n\n### `bb_get_file`\n\n**Получить содержимое файла:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"filePath\": \"src/main/java/com/acme/service/Application.java\",\n\t\"revision\": \"main\"\n}\n```\n\n### `bb_diff_branches`\n\n**Сравнить ветки:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceBranch\": \"develop\",\n\t\"targetBranch\": \"main\"\n}\n```\n\n### `bb_diff_commits`\n\n**Сравнить коммиты:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceCommit\": \"a1b2c3d\",\n\t\"targetCommit\": \"e4f5g6h\"\n}\n```\n\n### `bb_list_branches`\n\n**Список всех филиалов:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\"\n}\n```\n\n**Отфильтрованные ветки:**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"query\": \"feature/\",\n\t\"sort\": \"name\"\n}\n```\n\n## Команды CLI\n\nКоманды CLI используют `kebab-case` . Запустите `--help` для получения подробной информации (например, `mcp-atlassian-bitbucket ls-workspaces --help` ).\n\n* **ls-workspaces** : Выводит список рабочих пространств ( `--query` ). Пример: `mcp-atlassian-bitbucket ls-workspaces` .\n* **get-workspace** : Получает сведения о рабочей области ( `--workspace-slug` ). Пример: `mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp` .\n* **ls-repos** : Выводит список репозиториев ( `--workspace-slug` , `--project-key` , `--query` ). Пример: `mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp` .\n* **get-repo** : Получает сведения о репозитории ( `--workspace-slug` , `--repo-slug` ). Пример: `mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api` .\n* **search** : Поиск кода ( `--workspace-slug` , `--query` , `--scope` , `--language` ). Пример: `mcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"auth\"` .\n* **ls-prs** : выводит список PR ( `--workspace-slug` , `--repo-slug` , `--state` ). Пример: `mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api` .\n* **get-pr** : Получает сведения о PR ( `--workspace-slug` , `--repo-slug` , `--pr-id` ). Пример: `mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` .\n* **ls-pr-comments** : выводит список комментариев PR ( `--workspace-slug` , `--repo-slug` , `--pr-id` ). Пример: `mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` .\n* **add-pr-comment** : Добавляет комментарий PR ( `--workspace-slug` , `--repo-slug` , `--pr-id` , `--content` ). Пример: `mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 --content \"Looks good\"` .\n* **add-pr** : Создает PR ( `--workspace-slug` , `--repo-slug` , `--title` , `--source-branch` ). Пример: `mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug backend-api --title \"New feature\" --source-branch feature/login` .\n* **get-file** : Получает содержимое файла ( `--workspace-slug` , `--repo-slug` , `--file-path` ). Пример: `mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path src/main.js` .\n* **add-branch** : Создает ветку ( `--workspace-slug` , `--repo-slug` , `--new-branch-name` ). Пример: `mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug backend-api --new-branch-name feature/new` .\n\n### Список и просмотр рабочих пространств/репозиториев\n\n```bash\n# List all workspaces\nmcp-atlassian-bitbucket ls-workspaces\n\n# Get details of a specific workspace\nmcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp\n\n# List repositories in a workspace\nmcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ\n\n# Get details of a specific repository\nmcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api\n```\n\n### Работа с запросами на извлечение\n\n```bash\n# List open pull requests in a repository\nmcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN\n\n# Get details of a specific pull request with code changes\nmcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# List comments on a pull request\nmcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# Add a comment to a pull request\nmcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content \"Looks good to merge.\"\n\n# Create a new pull request\nmcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title \"Add login screen\" --source-branch feature/login\n```\n\n### Код и коммиты\n\n```bash\n# Search for code\nmcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"Logger\" --scope code --language typescript\n\n# View commit history\nmcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop\n\n# Get file content\nmcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path \"src/Application.java\" --revision main\n\n# Compare branches\nmcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main\n\n# Compare commits\nmcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h\n```\n\n### Управление филиалом\n\n```bash\n# List branches\nmcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query \"feature/\" --sort name\n\n# Create a new branch\nmcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main\n\n# Clone a repository\nmcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects\n```\n\n## Формат ответа\n\nВсе ответы отформатированы в формате Markdown, включая:\n\n* **Заголовок** : Выполненная операция или просмотренный объект.\n* **Контекст** : рабочая область, репозиторий, запрос на извлечение или информация о ветке.\n* **Контент** : основные данные, такие как содержимое файла, сведения о PR или результаты поиска.\n* **Метаданные** : временные метки, авторы и статистика.\n* **Различия** : изменения кода с подсветкой синтаксиса для различий между ветками/коммитами.\n\n### Подробности репозитория\n\n```markdown\n# Repository: backend-api\n\n**Workspace:** acme-corp\n**Full Name:** acme-corp/backend-api\n**Language:** Java\n**Created:** 2024-01-15 by John Smith\n**Updated:** 2025-05-10 (2 days ago)\n\n## Overview\nSpring Boot backend API for the ACME product suite.\n\n## Statistics\n- **Default Branch:** main\n- **Size:** 24.5 MB\n- **Commits:** 358\n- **Open PRs:** 4\n- **Forks:** 3\n\n## Recent Activity\n- PR #42: \"Add OAuth2 support\" by Jane Doe (Open)\n- PR #41: \"Fix pagination bug\" by Alex Kim (Merged)\n- PR #40: \"Update dependencies\" by John Smith (Merged)\n\n*Repository URL: https://bitbucket.org/acme-corp/backend-api*\n```\n\n### Обзор запроса на извлечение\n\n```markdown\n# Pull Request #42: Add OAuth2 support\n\n**Repository:** acme-corp/backend-api\n**Author:** Jane Doe\n**State:** OPEN\n**Created:** 2025-05-15 (4 days ago)\n**Updated:** 2025-05-18 (yesterday)\n\n## Description\nImplements OAuth2 authentication flow with support for:\n- Authorization code grant\n- Refresh tokens\n- Token caching\n\n## Changes\n- **Files changed:** 7\n- **Additions:** 245 lines\n- **Deletions:** 32 lines\n\n## Diff for src/auth/OAuthService.java\n\n\n\t@@ -10,6 +10,25 @@ public class OAuthService {\n\t\tprivate final TokenRepository tokenRepository;\n\t\tprivate final HttpClient httpClient;\n\t\n\t+ @Autowired\n\t+ public OAuthService(\n\t+ TokenRepository tokenRepository,\n\t+ HttpClient httpClient) {\n\t+ this.tokenRepository = tokenRepository;\n\t+ this.httpClient = httpClient;\n\t+ }\n\t+\n\t+ public TokenResponse refreshToken(String refreshToken) {\n\t+ // Validate refresh token\n\t+ if (StringUtils.isEmpty(refreshToken)) {\n\t+ throw new InvalidTokenException(\"Refresh token cannot be empty\");\n\t+ }\n\t+ \n\t+ // Call OAuth server for new access token\n\t+ return httpClient.post(\"/oauth/token\")\n\t+ .body(Map.of(\"grant_type\", \"refresh_token\", \"refresh_token\", refreshToken))\n\t+ .execute()\n\t+ .as(TokenResponse.class);\n\t+ }\n\n## Comments (3)\n1. **John Smith** (2 days ago):\n > Please add unit tests for the refresh token flow\n\n2. **Jane Doe** (yesterday):\n > Added tests in the latest commit\n\n3. **Approval by:** Alex Kim (yesterday)\n\n*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*\n```\n\n## Разработка\n\n```bash\n# Clone repository\ngit clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git\ncd mcp-server-atlassian-bitbucket\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev:server\n\n# Run tests\nnpm test\n```\n\n## Внося вклад\n\nВклады приветствуются! Пожалуйста:\n\n1. Создайте форк репозитория.\n2. Создайте ветку функций ( `git checkout -b feature/xyz` ).\n3. Зафиксируйте изменения ( `git commit -m \"Add xyz feature\"` ).\n4. Отправьте изменения в ветку ( `git push origin feature/xyz` ).\n5. Откройте запрос на извлечение.\n\nПодробности смотрите на [сайте CONTRIBUTING.md](CONTRIBUTING.md) .\n\n## Лицензия\n\n[Лицензия ISC](LICENSE)","Russian","ru-RU",{"_29":75,"_33":79,"_38":80},{"_31":76,"_33":77,"_35":78},"一种集成工具，使 Claude 等 AI 助手能够直接访问和交互 Bitbucket 存储库、拉取请求和代码，而无需复制/粘贴操作。","Atlassian Bitbucket MCP 服务器","# Atlassian Bitbucket MCP 服务器\n\n适用于 Atlassian Bitbucket Cloud 的 Node.js/TypeScript 模型上下文协议 (MCP) 服务器。它使 AI 系统（例如 Claude 或 Cursor AI 等 LLM）能够安全地实时与您的代码库、拉取请求、工作区和代码进行交互。\n\n[![NPM 版本](https://img.shields.io/npm/v/@aashari/mcp-server-atlassian-bitbucket)](https://www.npmjs.com/package/@aashari/mcp-server-atlassian-bitbucket) [![构建状态](https://img.shields.io/github/workflow/status/aashari/mcp-server-atlassian-bitbucket/CI)](https://github.com/aashari/mcp-server-atlassian-bitbucket/actions)\n\n## 为什么要使用此服务器？\n\n* **最少输入，最大输出**：简单的标识符无需额外的标志即可提供全面的详细信息。\n* **丰富的代码可视化**：通过文件统计、差异视图和智能上下文深入了解代码变化。\n* **安全的本地身份验证**：使用您的凭据在本地运行，永远不会在远程服务器上存储令牌。\n* **直观的 Markdown 响应**：所有输出均采用结构良好、一致的 Markdown 格式。\n* **完整的 Bitbucket 集成**：访问工作区、存储库、拉取请求、评论、代码搜索等。\n\n## 什么是 MCP？\n\n模型上下文协议 (MCP) 是一种开放标准，用于将 AI 系统安全地连接到外部工具和数据源。此服务器为 Bitbucket Cloud 实现了 MCP，使 AI 助手能够以编程方式与您的 Bitbucket 数据进行交互。\n\n## 先决条件\n\n* **Node.js** （>=18.x）：[下载](https://nodejs.org/)\n* **Bitbucket 云帐户**\n\n## 设置\n\n### 步骤 1：验证\n\n选择以下身份验证方法之一：\n\n#### 选项 A：Bitbucket 应用程序密码（推荐）\n\n从[Bitbucket App Passwords](https://bitbucket.org/account/settings/app-passwords/)生成一个。最低权限：\n\n* 工作区：阅读\n* 存储库：阅读\n* 拉取请求：阅读\n\n您还可以设置`BITBUCKET_DEFAULT_WORKSPACE`来指定未明确提供时的默认工作区。\n\n#### 选项 B：Atlassian API 令牌\n\n从[Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)生成一个。\n\n\\*\\*注意：\\*\\*强烈建议使用 Bitbucket App Passwords，因为它们提供更细粒度的、特定于 Bitbucket 的权限。\n\n### 第 2 步：配置凭证\n\n#### 选项 A：MCP 配置文件（推荐）\n\n编辑或创建`~/.mcp/configs.json` ：\n\n**使用 Bitbucket 应用程序密码：**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_BITBUCKET_USERNAME\": \"\",\n\t\t\t\"ATLASSIAN_BITBUCKET_APP_PASSWORD\": \"\"\n\t\t}\n\t}\n}\n```\n\n**使用 Atlassian API 令牌：**\n\n```json\n{\n\t\"bitbucket\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"bitbucket\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\"\n\t\t}\n\t}\n}\n```\n\n#### 选项 B：环境变量\n\n```bash\nexport ATLASSIAN_BITBUCKET_USERNAME=\"\"\nexport ATLASSIAN_BITBUCKET_APP_PASSWORD=\"\"\n```\n\n### 步骤3：安装并运行\n\n#### `npx`快速入门\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces\n```\n\n#### 全局安装\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-bitbucket\nmcp-atlassian-bitbucket ls-workspaces\n```\n\n### 步骤4：连接到AI助手\n\n配置与 MCP 兼容的客户端（例如 Claude、Cursor AI）：\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"bitbucket\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-bitbucket\"]\n\t\t}\n\t}\n}\n```\n\n## MCP 工具\n\nMCP 工具使用`snake_case`名称、 `camelCase`参数，并返回 Markdown 格式的响应。\n\n* **bb\\_ls\\_workspaces** ：列出可用的工作区（ `query` ：str opt）。用途：查看可访问的工作区。\n* **bb\\_get\\_workspace** ：获取工作区详细信息（ `workspaceSlug` ：str req）。用途：查看工作区信息。\n* **bb\\_ls\\_repos** ：列出存储库（ `workspaceSlug` ：str opt， `projectKey` ：str opt， `query` ：str opt， `role` ：str opt）。用途：查找存储库。\n* **bb\\_get\\_repo** ：获取存储库详细信息（ `workspaceSlug` ：str req， `repoSlug` ：str req）。用途：访问存储库信息。\n* **bb\\_search** ：搜索 Bitbucket 内容（ `workspaceSlug` ：str req、 `query` ：str req、 `scope` ：str opt、 `language` ：str opt、 `extension` ：str opt）。用途：查找代码或 PR。\n* **bb\\_ls\\_prs** ：列出拉取请求（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `state` ：str opt）。用途：查看打开或合并的 PR。\n* **bb\\_get\\_pr** ：获取 PR 详细信息（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `prId` ：str req）。用途：查看带有差异的 PR 详细信息。\n* **bb\\_ls\\_pr\\_comments** ：列出 PR 评论（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `prId` ：str req）。用途：查看 PR 讨论。\n* **bb\\_add\\_pr\\_comment** ：向 PR 添加评论（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `prId` ：str req、 `content` ：str req、 `inline` ：obj opt）。用途：向 PR 添加反馈。\n* **bb\\_add\\_pr** ：创建一个 PR（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `title` ：str req、 `sourceBranch` ：str req、 `targetBranch` ：str opt）。用途：创建新的 PR。\n* **bb\\_add\\_branch** ：创建一个分支（ `workspaceSlug` ：str req， `repoSlug` ：str req， `newBranchName` ：str req， `sourceBranchOrCommit` ：str opt）。用途：创建一个功能分支。\n* **bb\\_clone\\_repo** ：克隆存储库（ `workspaceSlug` ：str req， `repoSlug` ：str req， `targetPath` ：str req）。用途：本地克隆代码。\n* **bb\\_get\\_commit\\_history** ：获取提交历史记录（ `workspaceSlug` ：str req， `repoSlug` ：str req， `revision` ：str opt， `path` ：str opt）。用途：查看代码历史记录。\n* **bb\\_get\\_file** ：获取文件内容（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `filePath` ：str req、 `revision` ：str opt）。用途：查看特定文件。\n* **bb\\_diff\\_branches** ：显示分支之间的差异（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `sourceBranch` ：str req、 `targetBranch` ：str req）。用途：比较分支。\n* **bb\\_diff\\_commits** ：显示提交之间的差异（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `sourceCommit` ：str req、 `targetCommit` ：str req）。用途：比较提交。\n* **bb\\_list\\_branches** ：列出分支（ `workspaceSlug` ：str req、 `repoSlug` ：str req、 `query` ：str opt、 `sort` ：str opt）。用途：查看所有分支。\n\n### `bb_ls_workspaces`\n\n**列出所有工作区：**\n\n```json\n{}\n```\n\n**搜索工作区：**\n\n```json\n{ \"query\": \"devteam\" }\n```\n\n### `bb_get_workspace`\n\n**获取工作区详细信息：**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\" }\n```\n\n### `bb_ls_repos`\n\n**列出工作区中的存储库：**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"projectKey\": \"PROJ\" }\n```\n\n**使用默认工作区列出存储库：**\n\n```json\n{ \"projectKey\": \"PROJ\" }\n```\n\n### `bb_get_repo`\n\n**获取存储库详细信息：**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"backend-api\" }\n```\n\n### `bb_search`\n\n**搜索代码：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"query\": \"Logger\",\n\t\"scope\": \"code\",\n\t\"language\": \"typescript\"\n}\n```\n\n### `bb_ls_prs`\n\n**列出开放的 PR：**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"state\": \"OPEN\" }\n```\n\n### `bb_get_pr`\n\n**获取 PR 详细信息：**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_ls_pr_comments`\n\n**列出 PR 评论：**\n\n```json\n{ \"workspaceSlug\": \"acme-corp\", \"repoSlug\": \"frontend-app\", \"prId\": \"42\" }\n```\n\n### `bb_add_pr_comment`\n\n**添加一般评论：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Looks good.\"\n}\n```\n\n**添加内联评论：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"prId\": \"42\",\n\t\"content\": \"Consider refactoring.\",\n\t\"inline\": { \"path\": \"src/utils.js\", \"line\": 42 }\n}\n```\n\n### `bb_add_pr`\n\n**创建拉取请求：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"title\": \"Add login screen\",\n\t\"sourceBranch\": \"feature/login\"\n}\n```\n\n### `bb_add_branch`\n\n**创建新分支：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"newBranchName\": \"feature/new-feature\",\n\t\"sourceBranchOrCommit\": \"main\"\n}\n```\n\n### `bb_clone_repo`\n\n**克隆存储库：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"targetPath\": \"/Users/me/projects\"\n}\n```\n\n### `bb_get_commit_history`\n\n**查看提交历史记录：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\"\n}\n```\n\n**过滤提交历史记录：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"revision\": \"develop\",\n\t\"path\": \"src/main/java/com/acme/service/UserService.java\"\n}\n```\n\n### `bb_get_file`\n\n**获取文件内容：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"backend-api\",\n\t\"filePath\": \"src/main/java/com/acme/service/Application.java\",\n\t\"revision\": \"main\"\n}\n```\n\n### `bb_diff_branches`\n\n**比较分支：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceBranch\": \"develop\",\n\t\"targetBranch\": \"main\"\n}\n```\n\n### `bb_diff_commits`\n\n**比较提交：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"web-app\",\n\t\"sourceCommit\": \"a1b2c3d\",\n\t\"targetCommit\": \"e4f5g6h\"\n}\n```\n\n### `bb_list_branches`\n\n**列出所有分支：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\"\n}\n```\n\n**已过滤的分支：**\n\n```json\n{\n\t\"workspaceSlug\": \"acme-corp\",\n\t\"repoSlug\": \"frontend-app\",\n\t\"query\": \"feature/\",\n\t\"sort\": \"name\"\n}\n```\n\n## CLI 命令\n\nCLI 命令使用`kebab-case` )。运行`--help`获取详细信息（例如， `mcp-atlassian-bitbucket ls-workspaces --help` ）。\n\n* **ls-workspaces** ：列出工作区（ `--query` ）。例如： `mcp-atlassian-bitbucket ls-workspaces` 。\n* **get-workspace** ：获取工作区详情 ( `--workspace-slug` )。例如： `mcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp` 。\n* **ls-repos** ：列出仓库（ `--workspace-slug` 、 `--project-key` 、 `--query` ）。例如： `mcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp` 。\n* **get-repo** ：获取仓库详情（ `--workspace-slug` ， `--repo-slug` ）。例如： `mcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api` 。\n* **search** ：搜索代码（ `--workspace-slug` 、 `--query` 、 `--scope` 、 `--language` ）。例如： `mcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"auth\"` 。\n* **ls-prs** ：列出 PR（ `--workspace-slug` 、 `--repo-slug` 、 `--state` ）。例如： `mcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug backend-api` 。\n* **get-pr** ：获取 PR 详情（ `--workspace-slug` 、 `--repo-slug` 、 `--pr-id` ）。例如： `mcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` 。\n* **ls-pr-comments** ：列出 PR 注释（ `--workspace-slug` 、 `--repo-slug` 、 `--pr-id` ）。例如： `mcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug backend-api --pr-id 42` 。\n* **add-pr-comment** ：添加 PR 评论（ `--workspace-slug` 、 `--repo-slug` 、 `--pr-id` 、 `--content` ）。例如： `mcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug backend-api --pr-id 42 --content \"Looks good\"` 。\n* **add-pr** ：创建 PR（ `--workspace-slug` 、 `--repo-slug` 、 `--title` 、 `--source-branch` ）。例如： `mcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug backend-api --title \"New feature\" --source-branch feature/login` 。\n* **get-file** ：获取文件内容（ `--workspace-slug` 、 `--repo-slug` 、 `--file-path` ）。例如： `mcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path src/main.js` 。\n* **add-branch** ：创建分支（ `--workspace-slug` 、 `--repo-slug` 、 `--new-branch-name` ）。例如： `mcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug backend-api --new-branch-name feature/new` 。\n\n### 列出并查看工作区/存储库\n\n```bash\n# List all workspaces\nmcp-atlassian-bitbucket ls-workspaces\n\n# Get details of a specific workspace\nmcp-atlassian-bitbucket get-workspace --workspace-slug acme-corp\n\n# List repositories in a workspace\nmcp-atlassian-bitbucket ls-repos --workspace-slug acme-corp --project-key PROJ\n\n# Get details of a specific repository\nmcp-atlassian-bitbucket get-repo --workspace-slug acme-corp --repo-slug backend-api\n```\n\n### 使用拉取请求\n\n```bash\n# List open pull requests in a repository\nmcp-atlassian-bitbucket ls-prs --workspace-slug acme-corp --repo-slug frontend-app --state OPEN\n\n# Get details of a specific pull request with code changes\nmcp-atlassian-bitbucket get-pr --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# List comments on a pull request\nmcp-atlassian-bitbucket ls-pr-comments --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42\n\n# Add a comment to a pull request\nmcp-atlassian-bitbucket add-pr-comment --workspace-slug acme-corp --repo-slug frontend-app --pr-id 42 --content \"Looks good to merge.\"\n\n# Create a new pull request\nmcp-atlassian-bitbucket add-pr --workspace-slug acme-corp --repo-slug frontend-app --title \"Add login screen\" --source-branch feature/login\n```\n\n### 代码和提交\n\n```bash\n# Search for code\nmcp-atlassian-bitbucket search --workspace-slug acme-corp --query \"Logger\" --scope code --language typescript\n\n# View commit history\nmcp-atlassian-bitbucket get-commit-history --workspace-slug acme-corp --repo-slug backend-api --revision develop\n\n# Get file content\nmcp-atlassian-bitbucket get-file --workspace-slug acme-corp --repo-slug backend-api --file-path \"src/Application.java\" --revision main\n\n# Compare branches\nmcp-atlassian-bitbucket diff-branches --workspace-slug acme-corp --repo-slug web-app --source-branch develop --target-branch main\n\n# Compare commits\nmcp-atlassian-bitbucket diff-commits --workspace-slug acme-corp --repo-slug web-app --source-commit a1b2c3d --target-commit e4f5g6h\n```\n\n### 分支机构管理\n\n```bash\n# List branches\nmcp-atlassian-bitbucket list-branches --workspace-slug acme-corp --repo-slug frontend-app --query \"feature/\" --sort name\n\n# Create a new branch\nmcp-atlassian-bitbucket add-branch --workspace-slug acme-corp --repo-slug frontend-app --new-branch-name feature/new-feature --source-branch-or-commit main\n\n# Clone a repository\nmcp-atlassian-bitbucket clone --workspace-slug acme-corp --repo-slug backend-api --target-path ./cloned-projects\n```\n\n## 响应格式\n\n所有回复均为 Markdown 格式，包括：\n\n* **标题**：执行的操作或查看的实体。\n* **上下文**：工作区、存储库、拉取请求或分支信息。\n* **内容**：文件内容、PR 详细信息或搜索结果等主要数据。\n* **元数据**：时间戳、作者和统计数据。\n* **差异**：代码更改，语法突出显示分支/提交之间的差异。\n\n### 存储库详细信息\n\n```markdown\n# Repository: backend-api\n\n**Workspace:** acme-corp\n**Full Name:** acme-corp/backend-api\n**Language:** Java\n**Created:** 2024-01-15 by John Smith\n**Updated:** 2025-05-10 (2 days ago)\n\n## Overview\nSpring Boot backend API for the ACME product suite.\n\n## Statistics\n- **Default Branch:** main\n- **Size:** 24.5 MB\n- **Commits:** 358\n- **Open PRs:** 4\n- **Forks:** 3\n\n## Recent Activity\n- PR #42: \"Add OAuth2 support\" by Jane Doe (Open)\n- PR #41: \"Fix pagination bug\" by Alex Kim (Merged)\n- PR #40: \"Update dependencies\" by John Smith (Merged)\n\n*Repository URL: https://bitbucket.org/acme-corp/backend-api*\n```\n\n### 拉取请求审查\n\n```markdown\n# Pull Request #42: Add OAuth2 support\n\n**Repository:** acme-corp/backend-api\n**Author:** Jane Doe\n**State:** OPEN\n**Created:** 2025-05-15 (4 days ago)\n**Updated:** 2025-05-18 (yesterday)\n\n## Description\nImplements OAuth2 authentication flow with support for:\n- Authorization code grant\n- Refresh tokens\n- Token caching\n\n## Changes\n- **Files changed:** 7\n- **Additions:** 245 lines\n- **Deletions:** 32 lines\n\n## Diff for src/auth/OAuthService.java\n\n\n\t@@ -10,6 +10,25 @@ public class OAuthService {\n\t\tprivate final TokenRepository tokenRepository;\n\t\tprivate final HttpClient httpClient;\n\t\n\t+ @Autowired\n\t+ public OAuthService(\n\t+ TokenRepository tokenRepository,\n\t+ HttpClient httpClient) {\n\t+ this.tokenRepository = tokenRepository;\n\t+ this.httpClient = httpClient;\n\t+ }\n\t+\n\t+ public TokenResponse refreshToken(String refreshToken) {\n\t+ // Validate refresh token\n\t+ if (StringUtils.isEmpty(refreshToken)) {\n\t+ throw new InvalidTokenException(\"Refresh token cannot be empty\");\n\t+ }\n\t+ \n\t+ // Call OAuth server for new access token\n\t+ return httpClient.post(\"/oauth/token\")\n\t+ .body(Map.of(\"grant_type\", \"refresh_token\", \"refresh_token\", refreshToken))\n\t+ .execute()\n\t+ .as(TokenResponse.class);\n\t+ }\n\n## Comments (3)\n1. **John Smith** (2 days ago):\n > Please add unit tests for the refresh token flow\n\n2. **Jane Doe** (yesterday):\n > Added tests in the latest commit\n\n3. **Approval by:** Alex Kim (yesterday)\n\n*Pull Request URL: https://bitbucket.org/acme-corp/backend-api/pull-requests/42*\n```\n\n## 发展\n\n```bash\n# Clone repository\ngit clone https://github.com/aashari/mcp-server-atlassian-bitbucket.git\ncd mcp-server-atlassian-bitbucket\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev:server\n\n# Run tests\nnpm test\n```\n\n## 贡献\n\n欢迎投稿！请：\n\n1. 分叉存储库。\n2. 创建功能分支（ `git checkout -b feature/xyz` ）。\n3. 提交更改（ `git commit -m \"Add xyz feature\"` ）。\n4. 推送到分支（ `git push origin feature/xyz` ）。\n5. 打开拉取请求。\n\n有关详细信息，请参阅[CONTRIBUTING.md](CONTRIBUTING.md) 。\n\n## 执照\n\n[ISC 许可证](LICENSE)","Chinese","zh-CN","githubUser","locale",{"_84":85,"_86":87,"_13":120,"_130":42,"_131":42,"_132":133,"_136":137,"_158":-5,"_16":159,"_160":161,"_162":163,"_33":34,"_181":150,"_182":183,"_187":-5,"_188":-5,"_189":-5,"_190":191,"_197":-5,"_170":146,"_198":199,"_203":204,"_151":315,"_316":317},"addedAt","2025-03-25T19:15:20.897897288Z","argumentsJsonSchema",{"_88":89,"_100":101,"_107":119},"oneOf",[90,96],{"_91":92},"required",[93,94,95],"ATLASSIAN_SITE_NAME","ATLASSIAN_USER_EMAIL","ATLASSIAN_API_TOKEN",{"_91":97},[98,99],"ATLASSIAN_BITBUCKET_USERNAME","ATLASSIAN_BITBUCKET_APP_PASSWORD","properties",{"_102":103,"_95":109,"_93":111,"_94":113,"_98":115,"_99":117},"DEBUG",{"_104":105,"_31":106,"_107":108},"default","false","Enable debug logging","type","string",{"_31":110,"_107":108},"The API token created in your Atlassian account",{"_31":112,"_107":108},"Your Atlassian site name (e.g., for example.atlassian.net, enter example)",{"_31":114,"_107":108},"Your Atlassian account email address",{"_31":116,"_107":108},"Your Bitbucket username",{"_31":118,"_107":108},"The app password created in your Bitbucket account","object",[121,122,123,124,125,126,127,128,129],"category:version-control","category:developer-tools","category:code-execution","environment:network","hosting:hybrid","language:typescript","security_grade:a","quality_grade:a","license_grade:f","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":43,"_134":135},"url","https://github.com/aashari/mcp-server-atlassian-bitbucket","githubRepository",{"_138":139,"_140":141,"_142":143,"_144":145,"_33":146,"_147":148,"_153":154,"_155":-5,"_156":157},"defaultBranch","main","fullName","aashari/mcp-server-atlassian-bitbucket","githubTreeId",118836,"language","TypeScript","mcp-server-atlassian-bitbucket","owner",{"_149":150,"_151":152},"login","aashari","uid","WUhioEjlom","recentStargazers",1,"spdxLicense","stargazers",22,"glamaJson",3697,"inspectable",true,"integrations",[164,174],{"_165":166,"_31":172,"_151":173},"brand",{"_167":168,"_33":169,"_170":171},"logoSvgPath","M7.12 11.084a.683.683 0 00-1.16.126L.075 22.974a.703.703 0 00.63 1.018h8.19a.678.678 0 00.63-.39c1.767-3.65.696-9.203-2.406-12.52zM11.434.386a15.515 15.515 0 00-.906 15.317l3.95 7.9a.703.703 0 00.628.388h8.19a.703.703 0 00.63-1.017L12.63.38a.664.664 0 00-1.196.006z","Atlassian","slug","atlassian","Provides authentication and integration with Atlassian services, specifically focused on Bitbucket functionality using Atlassian API tokens.","m8vme93y4h",{"_165":175,"_31":179,"_151":180},{"_167":176,"_33":177,"_170":178},"M.778 1.213a.768.768 0 00-.768.892l3.263 19.81c.084.5.515.868 1.022.873H19.95a.772.772 0 00.77-.646l3.27-20.03a.768.768 0 00-.768-.891zM14.52 15.53H9.522L8.17 8.466h7.561z","Bitbucket","bitbucket","Allows AI assistants to interact with Bitbucket repositories, including listing repositories, accessing pull requests, viewing commit information, and exploring workspaces.","gdc7ngnw2k","namespace","npmPackage",{"_33":184,"_185":186},"@aashari/mcp-server-atlassian-bitbucket","weeklyDownloads",1716,"prompts","redditPostForeignId","resources","scores",{"_192":193,"_194":195,"_196":195},"license",0,"quality",100,"security","simpleIcon","supportedPlatforms",[200,201,202],"MACOS","WINDOWS","LINUX","tools",[205,230,240,258,279,300],{"_33":206,"_31":207,"_208":209},"list-workspaces","List Bitbucket workspaces available to your account.\n\nPURPOSE: Discovers workspaces you have access to with their slugs, names, and permission levels to help navigate Bitbucket's organization structure.\n\nWHEN TO USE:\n- When you need to discover what workspaces exist in your Bitbucket account\n- When you want to find the slugs needed for other Bitbucket operations\n- When you need to check what workspaces you have access to and their permission levels\n- Before accessing repositories or pull requests that require workspace information\n- When you're unfamiliar with the workspace organization structure\n\nWHEN NOT TO USE:\n- When you already know the workspace slug (use get-workspace or list-repositories instead)\n- When you need detailed workspace information (use get-workspace instead)\n- When you need to find specific repositories (use list-repositories after identifying the workspace)\n\nRETURNS: Formatted list of workspaces with slugs, names, and permission information, plus pagination details if available.\n\nEXAMPLES:\n- List all workspaces: {}\n- With sorting: {sort: \"name\"}\n- With pagination: {limit: 10, cursor: \"next-page-token\"}\n\nERRORS:\n- Authentication failures: Check your Bitbucket credentials\n- No workspaces found: You might not have access to any workspaces\n- Rate limiting: Use pagination and reduce query frequency","inputSchema",{"_107":119,"_210":211,"_100":212,"_228":229},"$schema","http://json-schema.org/draft-07/schema#",{"_213":214,"_216":217,"_219":220,"_225":226},"q",{"_107":108,"_31":215},"Query string to filter workspaces by name. Performs a partial text match on workspace names. Example: \"team\" would match \"my-team\" and \"team-project\". If omitted, returns all accessible workspaces.","sort",{"_107":108,"_31":218},"Field to sort results by. Common values: \"name\", \"created_on\", \"updated_on\". Prefix with \"-\" for descending order. Example: \"-name\" for reverse alphabetical order. If omitted, defaults to server-defined ordering.","limit",{"_107":221,"_222":195,"_31":223,"_224":193},"integer","maximum","Maximum number of workspaces to return (1-100). Use this to control the response size. If omitted, defaults to 25.","exclusiveMinimum","cursor",{"_107":108,"_31":227},"Pagination cursor for retrieving the next set of results. Obtain this value from the previous response when more results are available.","additionalProperties",false,{"_33":231,"_31":232,"_208":233},"get-workspace","Get detailed information about a specific Bitbucket workspace by slug.\n\nPURPOSE: Retrieves comprehensive workspace metadata including projects, permissions, and configuration.\n\nWHEN TO USE:\n- When you need detailed information about a specific workspace\n- When you need to check workspace permissions or membership\n- When you need to verify workspace settings or configuration\n- After using list-workspaces to identify the relevant workspace\n- Before performing operations that require detailed workspace context\n\nWHEN NOT TO USE:\n- When you don't know which workspace to look for (use list-workspaces first)\n- When you just need basic workspace information (slug, name)\n- When you're only interested in repositories (use list-repositories directly)\n\nRETURNS: Detailed workspace information including slug, name, type, description, projects, and permission levels.\n\nEXAMPLES:\n- Get workspace: {workspace: \"myteam\"}\n\nERRORS:\n- Workspace not found: Verify the workspace slug is correct\n- Permission errors: Ensure you have access to the requested workspace\n- Rate limiting: Cache workspace information when possible",{"_107":119,"_210":211,"_91":234,"_100":236,"_228":229},[235],"workspace",{"_235":237},{"_107":108,"_238":154,"_31":239},"minLength","Workspace slug to retrieve detailed information for. Must be a valid workspace slug from your Bitbucket account. Example: \"myteam\"",{"_33":241,"_31":242,"_208":243},"list-repositories","List Bitbucket repositories within a specific workspace.\n\nPURPOSE: Discovers repositories in a workspace with their slugs, names, and URLs to help navigate code resources.\n\nWHEN TO USE:\n- When you need to find repositories within a specific workspace\n- When you need repository slugs for other Bitbucket operations\n- When you want to explore available repositories before accessing specific content\n- When you need to check repository visibility and access levels\n- When looking for repositories with specific characteristics (language, size, etc.)\n\nWHEN NOT TO USE:\n- When you don't know which workspace to look for repos in (use list-workspaces first)\n- When you already know the repository slug (use get-repository instead)\n- When you need detailed repository information (use get-repository instead)\n- When you need to access pull requests or branches (use dedicated tools after identifying the repo)\n\nRETURNS: Formatted list of repositories with slugs, names, descriptions, URLs, and metadata, plus pagination info.\n\nEXAMPLES:\n- List all repos in workspace: {workspace: \"myteam\"}\n- With sorting: {workspace: \"myteam\", sort: \"name\"}\n- With filtering: {workspace: \"myteam\", query: \"api\"}\n- With pagination: {workspace: \"myteam\", limit: 10, cursor: \"next-page-token\"}\n\nERRORS:\n- Workspace not found: Verify the workspace slug is correct\n- Authentication failures: Check your Bitbucket credentials\n- Permission errors: Ensure you have access to the requested workspace\n- Rate limiting: Use pagination and reduce query frequency",{"_107":119,"_210":211,"_91":244,"_100":245,"_228":229},[235],{"_213":246,"_248":249,"_216":251,"_219":253,"_225":255,"_235":256},{"_107":108,"_31":247},"Query string to filter repositories using Bitbucket query syntax. Example: \"name ~ \\\"api\\\"\" for repositories with \"api\" in the name. If omitted, returns all repositories.","role",{"_107":108,"_31":250},"Filter repositories by the authenticated user's role. Common values: \"owner\", \"admin\", \"contributor\", \"member\". If omitted, returns repositories of all roles.",{"_107":108,"_31":252},"Field to sort results by. Common values: \"name\", \"created_on\", \"updated_on\". Prefix with \"-\" for descending order. Example: \"-updated_on\" for most recently updated first.",{"_107":221,"_222":195,"_31":254,"_224":193},"Maximum number of repositories to return (1-100). Use this to control the response size. If omitted, defaults to 25.",{"_107":108,"_31":227},{"_107":108,"_238":154,"_31":257},"Workspace slug containing the repositories. Must be a valid workspace slug from your Bitbucket account. Example: \"myteam\"",{"_33":259,"_31":260,"_208":261},"get-repository","Get detailed information about a specific Bitbucket repository.\n\nPURPOSE: Retrieves comprehensive repository metadata including branches, settings, permissions, and more.\n\nWHEN TO USE:\n- When you need detailed information about a specific repository\n- When you need repository URLs, clone links, or other reference information\n- When you need to check repository settings or permissions\n- After using list-repositories to identify the relevant repository\n- Before performing operations that require repository context (PRs, branches)\n\nWHEN NOT TO USE:\n- When you don't know which repository to look for (use list-repositories first)\n- When you just need basic repository information\n- When you're looking for pull request details (use list-pullrequests instead)\n- When you need content from multiple repositories (use list-repositories instead)\n\nRETURNS: Detailed repository information including slug, name, description, URLs, branch information, and settings.\n\nEXAMPLES:\n- Get repository: {workspace: \"myteam\", repoSlug: \"project-api\"}\n\nERRORS:\n- Repository not found: Verify workspace and repository slugs\n- Permission errors: Ensure you have access to the requested repository\n- Rate limiting: Cache repository information when possible",{"_107":119,"_210":211,"_91":262,"_100":264,"_228":229},[235,263],"repoSlug",{"_263":265,"_235":267,"_269":270,"_273":274,"_276":277},{"_107":108,"_238":154,"_31":266},"Repository slug to retrieve. This must be a valid repository in the specified workspace. Example: \"project-api\"",{"_107":108,"_238":154,"_31":268},"Workspace slug containing the repository. Must be a valid workspace slug from your Bitbucket account. Example: \"myteam\"","includeCommits",{"_107":271,"_31":272},"boolean","When true, includes recent commits information in the response. If omitted, defaults to false.","includeBranches",{"_107":271,"_31":275},"When true, includes information about repository branches in the response. If omitted, defaults to false.","includePullRequests",{"_107":271,"_31":278},"When true, includes open pull requests information in the response. If omitted, defaults to false.",{"_33":280,"_31":281,"_208":282},"list-pull-requests","List Bitbucket pull requests with optional filtering capabilities.\n\nPURPOSE: Allows you to find and browse pull requests across repositories with filtering options.\n\nWHEN TO USE:\n- When you need to find pull requests within a specific repository\n- When you want to check PR status (open, merged, declined, etc.)\n- When you need to track code review activity and progress\n- When you need PR IDs for other Bitbucket operations\n- When monitoring contributions from specific authors\n\nWHEN NOT TO USE:\n- When you don't know which repository to look in (use list-repositories first)\n- When you already know the PR ID (use get-pull-request instead)\n- When you need detailed PR content or comments (use get-pull-request instead)\n- When you need to browse repositories rather than PRs (use list-repositories)\n\nRETURNS: Formatted list of pull requests with IDs, titles, states, authors, branch information, and URLs, plus pagination info.\n\nEXAMPLES:\n- List all PRs in a repo: {workspace: \"myteam\", repoSlug: \"project-api\"}\n- Filter by state: {workspace: \"myteam\", repoSlug: \"project-api\", state: \"OPEN\"}\n- With pagination: {workspace: \"myteam\", repoSlug: \"project-api\", limit: 10, cursor: \"next-page-token\"}\n\nERRORS:\n- Repository not found: Verify workspace and repository slugs\n- Authentication failures: Check your Bitbucket credentials\n- Permission errors: Ensure you have access to the requested repository\n- Rate limiting: Use pagination and reduce query frequency",{"_107":119,"_210":211,"_91":283,"_100":284,"_228":229},[235,263],{"_219":285,"_287":288,"_225":296,"_263":297,"_235":299},{"_107":221,"_222":195,"_31":286,"_224":193},"Maximum number of pull requests to return (1-100). Use this to control the response size. If omitted, defaults to 25.","state",{"_289":290,"_107":108,"_31":295},"enum",[291,292,293,294],"OPEN","MERGED","DECLINED","SUPERSEDED","Filter pull requests by state. Options: \"OPEN\" (active PRs), \"MERGED\" (completed PRs), \"DECLINED\" (rejected PRs), or \"SUPERSEDED\" (replaced PRs). If omitted, defaults to showing all states.",{"_107":108,"_31":227},{"_107":108,"_238":154,"_31":298},"Repository slug containing the pull requests. This must be a valid repository in the specified workspace. Example: \"project-api\"",{"_107":108,"_238":154,"_31":268},{"_33":301,"_31":302,"_208":303},"get-pull-request","Get detailed information about a specific Bitbucket pull request.\n\nPURPOSE: Retrieves comprehensive PR data including description, comments, diff stats, reviewers, and branch information.\n\nWHEN TO USE:\n- When you need the full description and context of a specific PR\n- When you need to see comments, reviews, or approvals\n- When you need details about the source and destination branches\n- When you need diff statistics or changed files information\n- After using list-pull-requests to identify the relevant PR ID\n\nWHEN NOT TO USE:\n- When you don't know which PR to look for (use list-pull-requests first)\n- When you need to browse multiple PRs (use list-pull-requests instead)\n- When you only need basic PR information without comments or details\n- When you need repository information rather than PR details (use get-repository)\n\nRETURNS: Detailed PR information including title, description, status, author, reviewers, branches, comments, and related timestamps.\n\nEXAMPLES:\n- Get PR details: {workspace: \"myteam\", repoSlug: \"project-api\", id: 42}\n\nERRORS:\n- PR not found: Verify workspace, repository slugs, and PR ID\n- Permission errors: Ensure you have access to the requested PR\n- Rate limiting: Cache PR information when possible for frequently referenced PRs",{"_107":119,"_210":211,"_91":304,"_100":306,"_228":229},[235,263,305],"pullRequestId",{"_263":307,"_235":309,"_305":310,"_312":313},{"_107":108,"_238":154,"_31":308},"Repository slug containing the pull request. This must be a valid repository in the specified workspace. Example: \"project-api\"",{"_107":108,"_238":154,"_31":268},{"_107":221,"_31":311,"_224":193},"Numeric ID of the pull request to retrieve. Must be a valid pull request ID in the specified repository. Example: 42","includeComments",{"_107":271,"_31":314},"Whether to include comments in the response. When true, includes all comments on the pull request. If omitted, defaults to false.","d3mfwp6ce5","updatedAt","2025-05-26T17:03:09.095095134Z","meta",[320,323,325,332,335,337,340,343,346,349,352,354,357,360,362,364,366,368,370],{"_321":322},"title","Atlassian Bitbucket MCP Server | Glama",{"_324":42,"_33":31},"content",{"_326":327,"_328":329,"_330":331},"href","https://glama.ai/mcp/servers/@aashari/mcp-server-atlassian-bitbucket","rel","canonical","tagName","link",{"_324":34,"_333":334},"property","og:title",{"_324":42,"_333":336},"og:description",{"_324":338,"_333":339},"https://glama.ai/logo.png","og:logo",{"_324":341,"_333":342},"https://glama.ai/mcp/servers/@aashari/mcp-server-atlassian-bitbucket/og-image","og:image",{"_324":344,"_333":345},"630","og:image:height",{"_324":347,"_333":348},"1200","og:image:width",{"_324":350,"_333":351},"website","og:type",{"_324":327,"_333":353},"og:url",{"_324":355,"_333":356},"Glama – MCP Hosting Platform","og:site_name",{"_324":358,"_33":359},"summary_large_image","twitter:card",{"_324":355,"_33":361},"twitter:title",{"_324":42,"_33":363},"twitter:description",{"_324":341,"_33":365},"twitter:image",{"_324":344,"_33":367},"twitter:image:height",{"_324":347,"_33":369},"twitter:image:width",{"_371":372},"script:ld+json",{"_373":374,"_375":376},"@context","http://schema.org","@graph",[377],{"_373":378,"_379":380,"_381":382},"https://schema.org","@type","BreadcrumbList","itemListElement",[383,389,393,397],{"_379":384,"_385":386,"_33":387,"_388":154},"ListItem","item","https://glama.ai/","Glama","position",{"_379":384,"_385":390,"_33":391,"_388":392},"https://glama.ai/mcp","MCP",2,{"_379":384,"_385":394,"_33":395,"_388":396},"https://glama.ai/mcp/servers","Servers",3,{"_379":384,"_385":327,"_33":34,"_388":398},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_81":-5,"_29":402,"_318":478,"_513":-5},{"_84":85,"_86":403,"_13":416,"_130":42,"_131":42,"_132":417,"_136":418,"_158":-5,"_16":159,"_160":161,"_162":420,"_33":34,"_181":150,"_182":425,"_187":-5,"_188":-5,"_189":-5,"_190":426,"_197":-5,"_170":146,"_198":427,"_203":428,"_151":315,"_316":317},{"_88":404,"_100":409,"_107":119},[405,407],{"_91":406},[93,94,95],{"_91":408},[98,99],{"_102":410,"_95":411,"_93":412,"_94":413,"_98":414,"_99":415},{"_104":105,"_31":106,"_107":108},{"_31":110,"_107":108},{"_31":112,"_107":108},{"_31":114,"_107":108},{"_31":116,"_107":108},{"_31":118,"_107":108},[121,122,123,124,125,126,127,128,129],{"_35":43,"_134":135},{"_138":139,"_140":141,"_142":143,"_144":145,"_33":146,"_147":419,"_153":154,"_155":-5,"_156":157},{"_149":150,"_151":152},[421,423],{"_165":422,"_31":172,"_151":173},{"_167":168,"_33":169,"_170":171},{"_165":424,"_31":179,"_151":180},{"_167":176,"_33":177,"_170":178},{"_33":184,"_185":186},{"_192":193,"_194":195,"_196":195},[200,201,202],[429,436,441,451,460,470],{"_33":206,"_31":207,"_208":430},{"_107":119,"_210":211,"_100":431,"_228":229},{"_213":432,"_216":433,"_219":434,"_225":435},{"_107":108,"_31":215},{"_107":108,"_31":218},{"_107":221,"_222":195,"_31":223,"_224":193},{"_107":108,"_31":227},{"_33":231,"_31":232,"_208":437},{"_107":119,"_210":211,"_91":438,"_100":439,"_228":229},[235],{"_235":440},{"_107":108,"_238":154,"_31":239},{"_33":241,"_31":242,"_208":442},{"_107":119,"_210":211,"_91":443,"_100":444,"_228":229},[235],{"_213":445,"_248":446,"_216":447,"_219":448,"_225":449,"_235":450},{"_107":108,"_31":247},{"_107":108,"_31":250},{"_107":108,"_31":252},{"_107":221,"_222":195,"_31":254,"_224":193},{"_107":108,"_31":227},{"_107":108,"_238":154,"_31":257},{"_33":259,"_31":260,"_208":452},{"_107":119,"_210":211,"_91":453,"_100":454,"_228":229},[235,263],{"_263":455,"_235":456,"_269":457,"_273":458,"_276":459},{"_107":108,"_238":154,"_31":266},{"_107":108,"_238":154,"_31":268},{"_107":271,"_31":272},{"_107":271,"_31":275},{"_107":271,"_31":278},{"_33":280,"_31":281,"_208":461},{"_107":119,"_210":211,"_91":462,"_100":463,"_228":229},[235,263],{"_219":464,"_287":465,"_225":467,"_263":468,"_235":469},{"_107":221,"_222":195,"_31":286,"_224":193},{"_289":466,"_107":108,"_31":295},[291,292,293,294],{"_107":108,"_31":227},{"_107":108,"_238":154,"_31":298},{"_107":108,"_238":154,"_31":268},{"_33":301,"_31":302,"_208":471},{"_107":119,"_210":211,"_91":472,"_100":473,"_228":229},[235,263,305],{"_263":474,"_235":475,"_305":476,"_312":477},{"_107":108,"_238":154,"_31":308},{"_107":108,"_238":154,"_31":268},{"_107":221,"_31":311,"_224":193},{"_107":271,"_31":314},[479,481,483,485,487,488,489,490,491,492,493,494,495,496,497,498,499,500,501],{"_321":480},"Reviews | Atlassian Bitbucket MCP Server | Glama",{"_324":482,"_33":31},"Read community reviews and feedback for Atlassian Bitbucket MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_326":484,"_328":329,"_330":331},"https://glama.ai/mcp/servers/@aashari/mcp-server-atlassian-bitbucket/reviews",{"_324":486,"_333":334},"Reviews | Atlassian Bitbucket MCP Server",{"_324":482,"_333":336},{"_324":338,"_333":339},{"_324":341,"_333":342},{"_324":344,"_333":345},{"_324":347,"_333":348},{"_324":350,"_333":351},{"_324":484,"_333":353},{"_324":355,"_333":356},{"_324":358,"_33":359},{"_324":355,"_33":361},{"_324":482,"_33":363},{"_324":341,"_33":365},{"_324":344,"_33":367},{"_324":347,"_33":369},{"_371":502},{"_373":374,"_375":503},[504],{"_373":378,"_379":380,"_381":505},[506,507,508,509,510],{"_379":384,"_385":386,"_33":387,"_388":154},{"_379":384,"_385":390,"_33":391,"_388":392},{"_379":384,"_385":394,"_33":395,"_388":396},{"_379":384,"_385":327,"_33":34,"_388":398},{"_379":384,"_385":484,"_33":511,"_388":512},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API