Skip to main content
Glama
deenesjakoruzh
icy-r

Bitbucket MCP

by icy-r
OverviewSchemaRelated ServersScoreDiscussions
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: 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 토큰 (권장)

  1. Bitbucket API 토큰으로 이동합니다.

  2. 필요한 권한을 가진 새 토큰을 생성합니다.

  3. 환경 변수를 설정합니다:

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

앱 비밀번호

  1. Bitbucket 앱 비밀번호로 이동합니다.

  2. 필요한 권한을 가진 새 앱 비밀번호를 생성합니다.

  3. 사용자 이름과 앱 비밀번호를 사용하여 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
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
3wRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

Related MCP Servers

  • Bitbucket MCP Server

    jlromano
    A
    license
    B
    quality
    C
    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.
    16
    3,985
    MIT

  • Bitbucket MCP Server

    dmtr
    A
    license
    -
    quality
    C
    maintenance
    Enables interaction with Bitbucket repositories through the Model Context Protocol, supporting code search, repository management, branch creation, pull requests, and more.
    1
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Appeared in Searches

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