Bitbucket MCP

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: Atlassian Bitbucket MCP Server

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

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

3wRelease cycle

2Releases (12mo)

Commit activity

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Appeared in Searches

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

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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

URL: https://glama.ai/mcp/servers/icy-r/bitbucket-mcp?locale=ko-KR

⇱ Bitbucket MCP by icy-r | Glama