Bitbucket MCP
Ein Model Context Protocol (MCP)-Server für Bitbucket Cloud. Ermöglicht KI-Assistenten die Verwaltung von Repositories, Pull Requests, Pipelines und mehr.
Installation
Option 1: Verwendung von npx (Empfohlen)
Keine Installation erforderlich. Direkt ausführen:
npx @icy-r/bitbucket-mcpOption 2: Globale Installation
npm install -g @icy-r/bitbucket-mcp
bitbucket-mcpOption 3: Lokale Entwicklung
git clone https://github.com/icy-r/bitbucket-mcp.git
cd bitbucket-mcp
pnpm install
pnpm build
node dist/index.jsRelated MCP server: Atlassian Bitbucket MCP Server
MCP-Client-Konfiguration
Cursor IDE
Fügen Sie dies zu Ihren Cursor MCP-Einstellungen hinzu (~/.cursor/mcp.json unter Windows: %USERPROFILE%\.cursor\mcp.json):
Verwendung von npx (Empfohlen):
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "@icy-r/bitbucket-mcp"],
"env": {
"BITBUCKET_AUTH_METHOD": "api_token",
"BITBUCKET_USER_EMAIL": "your.email@example.com",
"BITBUCKET_API_TOKEN": "your_api_token"
}
}
}
}Verwendung eines lokalen Builds:
{
"mcpServers": {
"bitbucket": {
"command": "node",
"args": ["D:\\path\\to\\bitbucket-mcp\\dist\\index.js"],
"env": {
"BITBUCKET_AUTH_METHOD": "api_token",
"BITBUCKET_USER_EMAIL": "your.email@example.com",
"BITBUCKET_API_TOKEN": "your_api_token"
}
}
}
}Claude Desktop
Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS, %APPDATA%\Claude\claude_desktop_config.json unter Windows):
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "@icy-r/bitbucket-mcp"],
"env": {
"BITBUCKET_AUTH_METHOD": "api_token",
"BITBUCKET_USER_EMAIL": "your.email@example.com",
"BITBUCKET_API_TOKEN": "your_api_token"
}
}
}
}Andere MCP-Clients
Der Server folgt dem MCP-Standard und funktioniert mit jedem kompatiblen Client. Verwenden Sie das oben genannte Konfigurationsmuster und passen Sie die Pfade für Ihre Plattform entsprechend an.
Authentifizierung
API-Token (Empfohlen)
Gehen Sie zu Bitbucket API Tokens
Erstellen Sie ein neues Token mit den erforderlichen Berechtigungen
Setzen Sie die Umgebungsvariablen:
BITBUCKET_AUTH_METHOD=api_token
BITBUCKET_USER_EMAIL=your.email@example.com
BITBUCKET_API_TOKEN=your_api_tokenApp-Passwort
Gehen Sie zu Bitbucket App Passwords
Erstellen Sie ein neues App-Passwort mit den erforderlichen Berechtigungen
Verwenden Sie die
basic-Authentifizierungsmethode mit Ihrem Benutzernamen und App-Passwort
Umgebungsvariablen
Variable | Beschreibung | Erforderlich |
|
| Ja |
| Ihre Atlassian-E-Mail-Adresse | Für api_token |
| API-Token | Für api_token |
| Bitbucket-Benutzername | Für basic auth |
| App-Passwort | Für basic auth |
| Standard-Workspace (wird verwendet, wenn der Tool-Aufruf | Nein |
|
| Nein |
Verfügbare Tools
Tool | Aktionen |
| list, get, list_projects, list_members |
| list, get, create, delete, fork, get_file, list_source |
| list, get, create, update, merge, approve, unapprove, decline, list_comments, add_comment, get_diff |
| list_branches, get_branch, create_branch, delete_branch, list_tags, get_tag, create_tag |
| list, get, get_diff, get_diffstat |
| list, get, trigger, trigger_custom, stop, list_steps, get_step, get_logs, get_config, set_enabled, list_variables, get_variable, create_variable, update_variable, delete_variable |
| list, get, create, update, delete, list_comments, add_comment, vote, unvote, watch, unwatch |
| list, get, create, update, delete, list_workspace, get_workspace, create_workspace, update_workspace, delete_workspace |
Ausgabeformate
Steuern Sie die Ausführlichkeit der Antwort mit dem format-Parameter:
Format | Beschreibung | Token-Einsparung |
| Vollständige JSON-Ausgabe | 0% |
| Kompaktes TOON-Format | ~50% |
| Nur wesentliche Felder | ~76% |
Beispielanwendung:
{ "action": "list", "workspace": "my-workspace", "format": "compact" }Beispiele
Repositories in einem Workspace auflisten
{
"action": "list",
"workspace": "my-workspace"
}Einen Pull Request erstellen
{
"action": "create",
"workspace": "my-workspace",
"repo_slug": "my-repo",
"title": "Feature: Add new functionality",
"source_branch": "feature/new-feature",
"destination_branch": "main"
}Eine Pipeline auslösen
{
"action": "trigger",
"workspace": "my-workspace",
"repo_slug": "my-repo",
"branch_name": "main"
}Standard-Workspace
Setzen Sie BITBUCKET_WORKSPACE in Ihrer Umgebung, um den workspace-Parameter bei jedem Tool-Aufruf zu überspringen:
{ "action": "list", "repo_slug": "my-repo" }Entwicklung
# Clone the repository
git clone https://github.com/icy-r/bitbucket-mcp.git
cd bitbucket-mcp
# Install dependencies
pnpm install
# Build
pnpm build
# Run tests
pnpm test
# Run in development mode (watch)
pnpm dev
# Lint and format
pnpm lint
pnpm formatAnforderungen
Node.js >= 20.0.0
pnpm (für die Entwicklung)
Lizenz
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/icy-r/bitbucket-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
