Bitbucket Cloud 및 Server API와 통합하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 MCP 서버는 Cursor와 같은 AI 어시스턴트가 Bitbucket 저장소, 풀 요청 및 기타 자원과 상호작용할 수 있도록 합니다.

안전이 최우선

이 패키지는 안전하고 책임감 있게 운영되며, DELETE 작업을 사용하지 않아 데이터 손실 위험이 없습니다. 모든 풀 요청은 CodeQL로 분석되어 코드가 안전하게 유지되도록 합니다.

개요

공식 NPM 패키지를 확인해 보세요 이 서버는 모델 컨텍스트 프로토콜 표준을 구현하여 AI 비서가 비트버킷 데이터와 작업에 접근할 수 있도록 합니다. 다음 도구들을 포함합니다:

• 저장소 목록 및 검색
• 저장소 세부 정보 획득
• 풀 리퀘스트 가져오기
• 그리고 더…

설치

– 질문이 나온 이후로 많은 경우에 "BITBUCKET_USERNAME"이 보통 이메일입니다

NPX 사용 (권장)

이 MCP 서버를 사용하는 가장 쉬운 방법은 NPX를 통해 사용하는 것으로, 이를 통해 전역적으로 설치하지 않고도 실행할 수 있습니다:

수동 설치

또는 전역적으로 설치하거나 프로젝트의 일부로 설치할 수도 있습니다:

그 다음 다음과 같이 실행하세요:

구성

환경 변수

Bitbucket MCP

A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs. This MCP server enables AI assistants like Cursor to interact with your Bitbucket repositories, pull requests, and other resources.

Safety First

This is a safe and responsible package — no DELETE operations are used, so there’s no risk of data loss. Every pull request is analyzed with CodeQL to ensure the code remains secure.

Overview

Checkout out the official npm package This server implements the Model Context Protocol standard to provide AI assistants with access to Bitbucket data and operations. It includes tools for:

• Listing and retrieving repositories
• Getting repository details
• Fetching pull requests
• And more…

Installation

– Since it has been asked, in many cases we have seen - “BITBUCKET_USERNAME” is usually your email

Using NPX (Recommended)

The easiest way to use this MCP server is via NPX, which allows you to run it without installing it globally:

# Option A (recommended): API URL + explicit workspace
BITBUCKET_URL="https://api.bitbucket.org/2.0" \
BITBUCKET_WORKSPACE="your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx -y bitbucket-mcp@latest

# Option B (legacy-compatible): web URL only; workspace is auto-extracted
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx -y bitbucket-mcp@latest

Manual Installation

Alternatively, you can install it globally or as part of your project:

# Install globally
npm install -g bitbucket-mcp

# Or install in your project
npm install bitbucket-mcp

Then run it with:

# If installed globally (Option A)
BITBUCKET_URL="https://api.bitbucket.org/2.0" \
BITBUCKET_WORKSPACE="your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
bitbucket-mcp

# If installed globally (Option B - legacy-compatible)
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
bitbucket-mcp

# If installed in your project (Option A)
BITBUCKET_URL="https://api.bitbucket.org/2.0" \
BITBUCKET_WORKSPACE="your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx bitbucket-mcp