비트버킷 MCP

Bitbucket Cloud 및 Server API와 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 MCP 서버를 통해 Cursor와 같은 AI 어시스턴트가 Bitbucket 저장소, 풀 리퀘스트 및 기타 리소스와 상호 작용할 수 있습니다.

안전이 최우선

안전하고 신뢰할 수 있는 패키지입니다. DELETE 작업이 사용되지 않으므로 데이터 손실 위험이 없습니다. 모든 풀 리퀘스트는 CodeQL로 분석되어 코드의 보안을 유지합니다.

개요

공식 npm 패키지를 확인해 보세요. 이 서버는 AI 어시스턴트가 Bitbucket 데이터 및 작업에 액세스할 수 있도록 모델 컨텍스트 프로토콜(Model Context Protocol) 표준을 구현합니다. 여기에는 다음 도구가 포함되어 있습니다.

저장소 나열 및 검색
저장소 세부 정보 가져오기
풀 리퀘스트 가져오기
그리고 더 많은 것들...

설치

NPX 사용(권장)

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

지엑스피1

수동 설치

또는 프로젝트의 일부로 또는 전역적으로 설치할 수 있습니다.

# Install globally
npm install -g bitbucket-mcp

# Or install in your project
npm install bitbucket-mcp

다음으로 다음을 실행합니다.

# If installed globally
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
bitbucket-mcp

# If installed in your project
BITBUCKET_URL="https://bitbucket.org/your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx bitbucket-mcp

구성

환경 변수

다음 환경 변수를 사용하여 서버를 구성하세요.

변하기 쉬운	설명	필수의
`BITBUCKET_URL`	Bitbucket 기본 URL(예: " https://bitbucket.org/your-workspace ")	예
`BITBUCKET_USERNAME`	Bitbucket 사용자 이름	예*
`BITBUCKET_PASSWORD`	Bitbucket 앱 비밀번호	예*
`BITBUCKET_TOKEN`	Bitbucket 액세스 토큰(사용자 이름/비밀번호 대체)	아니요
`BITBUCKET_WORKSPACE`	지정되지 않은 경우 사용할 기본 작업 공간	아니요

* BITBUCKET_TOKEN 또는 BITBUCKET_USERNAME 과 BITBUCKET_PASSWORD 모두 제공해야 합니다.

Bitbucket 앱 비밀번호 생성

Bitbucket 계정에 로그인하세요
개인 설정 > 앱 비밀번호로 이동하세요.
다음 권한으로 새로운 앱 비밀번호를 만드세요.
- 저장소: 읽기
- 풀 리퀘스트: 읽기, 쓰기
생성된 비밀번호를 복사하여 BITBUCKET_PASSWORD 환경 변수로 사용합니다.

커서와의 통합

이 MCP 서버를 Cursor와 통합하려면:

커서 열기
설정 > 확장 프로그램으로 이동하세요
"모델 컨텍스트 프로토콜"을 클릭하세요
새로운 MCP 구성을 추가합니다.

"bitbucket": {
  "command": "npx",
  "env": {
    "BITBUCKET_URL": "https://bitbucket.org/your-workspace",
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_PASSWORD": "your-app-password"
  },
  "args": ["-y", "bitbucket-mcp@latest"]
}

구성을 저장합니다
Cursor에서 "/bitbucket" 명령을 사용하여 Bitbucket 저장소 및 풀 요청에 액세스합니다.

커서를 사용하여 로컬 빌드 사용

로컬로 개발하고 변경 사항을 테스트하려는 경우:

"bitbucket-local": {
  "command": "node",
  "env": {
    "BITBUCKET_URL": "https://bitbucket.org/your-workspace",
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_PASSWORD": "your-app-password"
  },
  "args": ["/path/to/your/local/bitbucket-mcp/dist/index.js"]
}

사용 가능한 도구

이 MCP 서버는 Bitbucket 저장소 및 풀 리퀘스트와 상호 작용하는 도구를 제공합니다. 사용 가능한 작업의 전체 목록은 다음과 같습니다.

저장소 작업

`listRepositories`

작업 공간의 저장소를 나열합니다.

매개변수:

workspace (선택 사항): Bitbucket 작업 공간 이름
limit (선택 사항): 반환할 저장소의 최대 수

`getRepository`

특정 저장소에 대한 세부 정보를 가져옵니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그

풀 리퀘스트 작업

`getPullRequests`

저장소에 대한 풀 리퀘스트를 받습니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
state (선택 사항): 풀 요청 상태( OPEN , MERGED , DECLINED , SUPERSEDED )
limit (선택 사항): 반환할 풀 요청의 최대 수

`createPullRequest`

새로운 풀 리퀘스트를 생성합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
title : 풀 리퀘스트 제목
description : 풀 리퀘스트 설명
sourceBranch : 소스 브랜치 이름
targetBranch : 대상 브랜치 이름
reviewers (선택 사항): 리뷰어 사용자 이름 목록

`getPullRequest`

특정 풀 리퀘스트에 대한 세부 정보를 가져옵니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`updatePullRequest`

풀 리퀘스트를 업데이트합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
다양한 선택적 업데이트 매개변수(제목, 설명 등)

`getPullRequestActivity`

풀 리퀘스트에 대한 활동 로그를 가져옵니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`approvePullRequest`

풀 리퀘스트를 승인합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`unapprovePullRequest`

풀 리퀘스트에서 승인을 제거합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`declinePullRequest`

풀 리퀘스트를 거부합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
message (선택 사항): 거부 이유

`mergePullRequest`

풀 리퀘스트를 병합합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
message (선택 사항): 커밋 메시지 병합
strategy (선택 사항): 병합 전략( merge-commit , squash , fast-forward )

`requestChanges`

풀 리퀘스트에 대한 변경 사항을 요청합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`removeChangeRequest`

풀 리퀘스트에서 변경 요청을 제거합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

풀 리퀘스트 주석 작업

`getPullRequestComments`

풀 리퀘스트에 대한 댓글을 나열합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`createPullRequestComment`

풀 리퀘스트에 대한 댓글을 생성합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
content : 댓글 내용
inline (선택 사항): 인라인 주석 정보

`getPullRequestComment`

풀 리퀘스트에 대한 구체적인 의견을 받습니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
comment_id : 댓글 ID

`updatePullRequestComment`

풀 리퀘스트에 대한 댓글을 업데이트합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
comment_id : 댓글 ID
content : 업데이트된 댓글 내용

`deletePullRequestComment`

풀 리퀘스트에 대한 댓글을 삭제합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
comment_id : 댓글 ID

`resolveComment`

풀 리퀘스트에 대한 댓글 스레드를 해결합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
comment_id : 댓글 ID

`reopenComment`

풀 리퀘스트에서 해결된 댓글 스레드를 다시 엽니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
comment_id : 댓글 ID

풀 리퀘스트 Diff 작업

`getPullRequestDiff`

풀 리퀘스트에 대한 diff를 가져옵니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`getPullRequestDiffStat`

풀 리퀘스트에 대한 diff 통계를 가져옵니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`getPullRequestPatch`

풀 리퀘스트에 대한 패치를 가져옵니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

풀 리퀘스트 작업 운영

`getPullRequestTasks`

풀 리퀘스트에 대한 작업을 나열합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`createPullRequestTask`

풀 리퀘스트에 대한 작업을 생성합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
content : 작업 내용
comment (선택 사항): 작업과 연결할 주석 ID
pending (선택 사항): 작업이 보류 중인지 여부

`getPullRequestTask`

풀 리퀘스트에 대한 특정 작업을 가져옵니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
task_id : 작업 ID

`updatePullRequestTask`

풀 리퀘스트에 대한 작업을 업데이트합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
task_id : 작업 ID
content (선택 사항): 업데이트된 작업 내용
state (선택 사항): 업데이트된 작업 상태

`deletePullRequestTask`

풀 리퀘스트에서 작업을 삭제합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID
task_id : 작업 ID

기타 풀 리퀘스트 작업

`getPullRequestCommits`

풀 리퀘스트에 대한 커밋을 나열합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

`getPullRequestStatuses`

풀 리퀘스트에 대한 커밋 상태를 나열합니다.

매개변수:

workspace : Bitbucket 작업공간 이름
repo_slug : 저장소 슬러그
pull_request_id : 풀 리퀘스트 ID

개발

필수 조건

Node.js 18 이상
npm 또는 yarn

설정

# Clone the repository
git clone https://github.com/MatanYemini/bitbucket-mcp.git
cd bitbucket-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Integrations