비트버킷 MCP

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

안전이 최우선

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

Related MCP server: Bitbucket MCP Server

개요

공식 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_TOKEN 또는 BITBUCKET_USERNAME 과 BITBUCKET_PASSWORD 모두 제공해야 합니다.

Bitbucket 앱 비밀번호 생성

1. Bitbucket 계정에 로그인하세요

2. 개인 설정 > 앱 비밀번호로 이동하세요.

3. 다음 권한으로 새로운 앱 비밀번호를 만드세요.

   • 저장소: 읽기

   • 풀 리퀘스트: 읽기, 쓰기

4. 생성된 비밀번호를 복사하여 BITBUCKET_PASSWORD 환경 변수로 사용합니다.

커서와의 통합

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

1. 커서 열기

2. 설정 > 확장 프로그램으로 이동하세요

3. "모델 컨텍스트 프로토콜"을 클릭하세요

4. 새로운 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"]
}

5. 구성을 저장합니다

6. 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

모래밭

• GitHub 저장소

• npm 패키지

• 모델 컨텍스트 프로토콜

• Bitbucket REST API - 풀 리퀘스트