de en es ja ko ru zh

Bitbucket MCP

Name: Bitbucket MCP
Author: icy-r

by icy-r

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Bitbucket MCP

npm version License: MIT

Bitbucket Cloud를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. AI 어시스턴트가 저장소, 풀 리퀘스트, 파이프라인 등을 관리할 수 있게 해줍니다.

설치

옵션 1: npx 사용 (권장)

설치가 필요 없습니다. 바로 실행하세요:

npx @icy-r/bitbucket-mcp

옵션 2: 전역 설치

npm install -g @icy-r/bitbucket-mcp
bitbucket-mcp

옵션 3: 로컬 개발

git clone https://github.com/icy-r/bitbucket-mcp.git
cd bitbucket-mcp
pnpm install
pnpm build
node dist/index.js

Related MCP server: mcp-bitbucket

MCP 클라이언트 설정

Cursor IDE

Cursor MCP 설정(~/.cursor/mcp.json, Windows의 경우 %USERPROFILE%\.cursor\mcp.json)에 추가하세요:

npx 사용 (권장):

{
  "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"
      }
    }
  }
}

로컬 빌드 사용:

{
  "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

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (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"
      }
    }
  }
}

기타 MCP 클라이언트

이 서버는 MCP 표준을 따르며 호환되는 모든 클라이언트와 작동합니다. 위 설정 패턴을 사용하고 플랫폼에 맞게 경로를 조정하세요.

인증

API 토큰 (권장)

Bitbucket API 토큰으로 이동합니다.
필요한 권한을 가진 새 토큰을 생성합니다.
환경 변수를 설정합니다:

BITBUCKET_AUTH_METHOD=api_token
BITBUCKET_USER_EMAIL=your.email@example.com
BITBUCKET_API_TOKEN=your_api_token

앱 비밀번호

Bitbucket 앱 비밀번호로 이동합니다.
필요한 권한을 가진 새 앱 비밀번호를 생성합니다.
사용자 이름과 앱 비밀번호를 사용하여 basic 인증 방식을 사용합니다.

환경 변수

변수	설명	필수 여부
`BITBUCKET_AUTH_METHOD`	`api_token`, `oauth`, `basic`	예
`BITBUCKET_USER_EMAIL`	Atlassian 이메일	api_token의 경우
`BITBUCKET_API_TOKEN`	API 토큰	api_token의 경우
`BITBUCKET_USERNAME`	Bitbucket 사용자 이름	basic 인증의 경우
`BITBUCKET_APP_PASSWORD`	앱 비밀번호	basic 인증의 경우
`BITBUCKET_WORKSPACE`	기본 워크스페이스 (도구 호출 시 `workspace` 생략 가능)	아니오
`BITBUCKET_OUTPUT_FORMAT`	`json`, `toon`, `compact`	아니오

사용 가능한 도구

도구	작업
`bitbucket_workspaces`	list, get, list_projects, list_members
`bitbucket_repositories`	list, get, create, delete, fork, get_file, list_source
`bitbucket_pull_requests`	list, get, create, update, merge, approve, unapprove, decline, list_comments, add_comment, get_diff
`bitbucket_branches`	list_branches, get_branch, create_branch, delete_branch, list_tags, get_tag, create_tag
`bitbucket_commits`	list, get, get_diff, get_diffstat
`bitbucket_pipelines`	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
`bitbucket_issues`	list, get, create, update, delete, list_comments, add_comment, vote, unvote, watch, unwatch
`bitbucket_webhooks`	list, get, create, update, delete, list_workspace, get_workspace, create_workspace, update_workspace, delete_workspace

출력 형식

format 매개변수로 응답 상세 수준을 제어합니다:

형식	설명	토큰 절약
`json`	전체 JSON 출력	0%
`toon`	압축된 TOON 형식	~50%
`compact`	필수 필드만 포함	~76%

사용 예시:

{ "action": "list", "workspace": "my-workspace", "format": "compact" }

예시

워크스페이스의 저장소 목록 조회

{
  "action": "list",
  "workspace": "my-workspace"
}

풀 리퀘스트 생성

{
  "action": "create",
  "workspace": "my-workspace",
  "repo_slug": "my-repo",
  "title": "Feature: Add new functionality",
  "source_branch": "feature/new-feature",
  "destination_branch": "main"
}

파이프라인 트리거

{
  "action": "trigger",
  "workspace": "my-workspace",
  "repo_slug": "my-repo",
  "branch_name": "main"
}

기본 워크스페이스

환경 변수에 BITBUCKET_WORKSPACE를 설정하면 모든 도구 호출 시 workspace 매개변수를 생략할 수 있습니다:

{ "action": "list", "repo_slug": "my-repo" }

개발

# 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 format

요구 사항

Node.js >= 20.0.0
pnpm (개발용)

라이선스

MIT

Available Tools

8 tools

bitbucket_branchesB

Manage Bitbucket branches and tags. Actions:

list_branches: List all branches in a repository
get_branch: Get details of a specific branch
create_branch: Create a new branch from a commit/ref
delete_branch: Delete a branch
list_tags: List all tags in a repository
get_tag: Get details of a specific tag
create_tag: Create a new tag

Inputs: action (required), repo_slug (required), workspace, branch_name, +8 more.

bitbucket_commitsB

Manage Bitbucket commits and diffs. Actions:

list: List commits in a repository
get: Get details of a specific commit
get_diff: Get diff between two refs (e.g., "branch1..branch2" or "commit1..commit2")
get_diffstat: Get diffstat (summary of changes) between two refs

Inputs: action (required), repo_slug (required), workspace, commit_hash, +8 more.

bitbucket_issuesB

Manage Bitbucket issue tracking. Actions:

list: List issues in a repository
get: Get details of a specific issue
create: Create a new issue
update: Update an existing issue
delete: Delete an issue
list_comments: List comments on an issue
add_comment: Add a comment to an issue
vote: Vote for an issue
unvote: Remove vote from an issue
watch: Watch an issue for notifications
unwatch: Stop watching an issue

Inputs: action (required), repo_slug (required), workspace, issue_id, +12 more.

bitbucket_pipelinesA

Manage Bitbucket Pipelines CI/CD. Actions:

list: List pipelines in a repository
get: Get details of a specific pipeline
trigger: Trigger a new pipeline run on a branch
trigger_custom: Trigger a custom pipeline with a specific pattern
stop: Stop a running pipeline
list_steps: List steps of a pipeline
get_step: Get details of a specific step
get_logs: Get logs for a pipeline step
get_config: Get pipeline configuration (enabled status)
set_enabled: Enable or disable pipelines for a repository
list_variables: List pipeline variables
get_variable: Get a specific pipeline variable
create_variable: Create a pipeline variable
update_variable: Update a pipeline variable
delete_variable: Delete a pipeline variable

Inputs: action (required), repo_slug (required), workspace, pipeline_uuid, +14 more.

bitbucket_pull_requestsB

Manage Bitbucket pull requests. Actions:

list: List pull requests in a repository
get: Get pull request details
create: Create a new pull request
update: Update a pull request
merge: Merge a pull request
approve: Approve a pull request
unapprove: Remove approval from a pull request
decline: Decline a pull request
list_comments: List comments on a pull request
add_comment: Add a comment to a pull request
get_diff: Get the diff of a pull request

Inputs: action (required), repo_slug (required), workspace, pr_id, +18 more.

bitbucket_repositoriesC

Manage Bitbucket repositories. Actions:

list: List repositories in a workspace
get: Get repository details
create: Create a new repository
delete: Delete a repository
fork: Fork a repository
get_file: Get file content from a repository
list_source: List files/directories in a repository path

Inputs: action (required), workspace, repo_slug, q, +13 more.

bitbucket_webhooksB

Manage Bitbucket webhooks for repositories and workspaces. Actions:

list: List webhooks for a repository
get: Get details of a specific webhook
create: Create a new webhook
update: Update an existing webhook
delete: Delete a webhook
list_workspace: List webhooks for a workspace
get_workspace: Get a workspace webhook
create_workspace: Create a workspace webhook
update_workspace: Update a workspace webhook
delete_workspace: Delete a workspace webhook

Inputs: action (required), workspace, repo_slug, webhook_uuid, +8 more.

bitbucket_workspacesB

Manage Bitbucket workspaces. Actions:

list: List all accessible workspaces
get: Get details of a specific workspace
list_projects: List projects in a workspace
list_members: List members of a workspace

Inputs: action (required), workspace, page, pagelen, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.7/5.0

Scored 2026-05-05 02:15 across 8 tools

Disambiguation5/5

Each tool covers a distinct Bitbucket domain (branches, commits, issues, pipelines, pull requests, repositories, webhooks, workspaces) with no overlap in primary functionality. An agent can easily select the correct tool for a task.

Naming Consistency5/5

All tools follow a consistent 'bitbucket_<domain>' pattern, and within each tool, action names are short, clear verbs. The naming scheme is predictable and uniform across the entire set.

Tool Count5/5

With 8 tools covering the major Bitbucket features, the count is well-scoped for the platform's complexity. Each tool represents a natural grouping of related actions, avoiding unnecessary fragmentation or lumping.

Completeness5/5

The tool surface covers all core Bitbucket operations: source control (branches, commits), collaboration (PRs, issues), CI/CD (pipelines), repository management, webhooks, and workspaces. Critical workflows like create/update/delete are present where applicable.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

hithereiamaliff-mcp-nextcloud
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
238
https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp
saidsef-mcp-github-pr-issue-analyser
ai.smithery
A Model Context Protocol (MCP) application for automated GitHub PR analysis and issue management.…
Version Control Developer Tools Project Management
26
https://server.smithery.ai/@saidsef/mcp-github-pr-issue-analyser/mcp
GitHub
io.github.github
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Version Control Developer Tools CI/CD & DevOps
1234,306
https://api.githubcopilot.com/mcp/
KukGit
io.github.amithkukllod777
Read and write KukGit repositories, files, issues and pull requests from an AI assistant.
Version Control Project Management Developer Tools
1
https://git.kuklabs.com/mcp

Related MCP Servers

Bitbucket MCP Server
Version Control Developer Tools
jlromano
A
license
B
quality
D
maintenance
Enables LLMs to interact with Bitbucket repositories to manage pull requests, branches, and commits through the Model Context Protocol. It supports repository operations such as searching code, accessing file contents, and comparing branches using natural language.
Updated a year ago (2025-08-26 13:10 UTC)
16
7,061 npm
MIT
mcp-bitbucket
Version Control Developer Tools
n11techhub
A
license
Not graded
quality
C
maintenance
Enables AI systems to securely interact with self-hosted Bitbucket repositories, pull requests, projects, and code through the Model Context Protocol.
Updated 4 months ago (2026-07-23 20:51 UTC)
36 npm
23
Apache 2.0
Bitbucket MCP
Version Control Developer Tools CI/CD & DevOps
alejandrobishop83
A
license
Not graded
quality
A
maintenance
Enables AI assistants to list and retrieve repositories, inspect and create pull requests, and access Bitbucket Cloud and Server data and operations through the Model Context Protocol.
Updated a month ago (2026-10-14 06:30 UTC)
7,061 npm
MIT
Bitbucket MCP
Version Control Developer Tools CI/CD & DevOps
MalgorzataKose50
A
license
Not graded
quality
A
maintenance
Enables AI assistants to interact with Bitbucket Cloud and Server APIs, providing access to repositories, pull requests, and related operations through the Model Context Protocol.
Updated 24 days ago (2026-10-17 05:50 UTC)
7,061 npm
MIT

Appeared in Searches

A server for finding information about Bitbucket, the Git repository hosting service

Bitbucket MCP

설치

옵션 1: npx 사용 (권장)

옵션 2: 전역 설치

옵션 3: 로컬 개발

MCP 클라이언트 설정

Cursor IDE

Claude Desktop

기타 MCP 클라이언트

인증

API 토큰 (권장)

앱 비밀번호

환경 변수

사용 가능한 도구

출력 형식

예시

워크스페이스의 저장소 목록 조회

풀 리퀘스트 생성

파이프라인 트리거

기본 워크스페이스

개발

요구 사항

라이선스

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Bitbucket MCP Server

mcp-bitbucket

Bitbucket MCP

Bitbucket MCP

Appeared in Searches