Bitbucket 서버 MCP

Bitbucket 서버 풀 리퀘스트 관리를 위한 MCP(Model Context Protocol) 서버입니다. 이 서버는 MCP 프로토콜을 통해 Bitbucket 서버 API와 상호 작용할 수 있는 도구와 리소스를 제공합니다.

대장간 배지

요구 사항

노드.js >= 16

Related MCP server: GitHub MCP Server

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Bitbucket Server를 자동으로 설치하려면:

지엑스피1

수동 설치

npm install

짓다

npm run build

특징

이 서버는 Bitbucket 서버 통합을 위해 다음과 같은 도구를 제공합니다.

`create_pull_request`

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

매개변수:

project : Bitbucket 프로젝트 키(설정된 경우 BITBUCKET_DEFAULT_PROJECT로 기본 설정됨)
repository (필수): 저장소 슬러그
title (필수): PR 제목
description : PR 설명
sourceBranch (필수): 소스 브랜치 이름
targetBranch (필수): 대상 브랜치 이름
reviewers : 리뷰어 사용자 이름 배열

`get_pull_request`

특정 풀 리퀘스트에 대한 자세한 정보를 검색합니다.

매개변수:

project : Bitbucket 프로젝트 키(설정된 경우 BITBUCKET_DEFAULT_PROJECT로 기본 설정됨)
repository (필수): 저장소 슬러그
prId (필수): 풀 리퀘스트 ID

`merge_pull_request`

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

매개변수:

project : Bitbucket 프로젝트 키(설정된 경우 BITBUCKET_DEFAULT_PROJECT로 기본 설정됨)
repository (필수): 저장소 슬러그
prId (필수): 풀 리퀘스트 ID
message : 병합 커밋 메시지
strategy : 다음 중 하나:
- merge-commit (기본값)
- squash
- fast-forward

`decline_pull_request`

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

매개변수:

project : Bitbucket 프로젝트 키(설정된 경우 BITBUCKET_DEFAULT_PROJECT로 기본 설정됨)
repository (필수): 저장소 슬러그
prId (필수): 풀 리퀘스트 ID
message : 거절 사유

`add_comment`

풀 리퀘스트에 주석을 추가합니다.

매개변수:

project : Bitbucket 프로젝트 키(설정된 경우 BITBUCKET_DEFAULT_PROJECT로 기본 설정됨)
repository (필수): 저장소 슬러그
prId (필수): 풀 리퀘스트 ID
text (필수): 댓글 텍스트
parentId : 답변에 대한 상위 댓글 ID

`get_diff`

풀 리퀘스트에 대한 diff를 검색합니다.

매개변수:

project : Bitbucket 프로젝트 키(설정된 경우 BITBUCKET_DEFAULT_PROJECT로 기본 설정됨)
repository (필수): 저장소 슬러그
prId (필수): 풀 리퀘스트 ID
contextLines : 컨텍스트 줄 수(기본값: 10)

`get_reviews`

승인 및 검토를 포함하여 풀 리퀘스트의 검토 기록을 가져옵니다.

매개변수:

project : Bitbucket 프로젝트 키(설정된 경우 BITBUCKET_DEFAULT_PROJECT로 기본 설정됨)
repository (필수): 저장소 슬러그
prId (필수): 풀 리퀘스트 ID

종속성

@modelcontextprotocol/sdk - MCP 프로토콜 구현을 위한 SDK
axios - API 요청을 위한 HTTP 클라이언트
winston - 로깅 프레임워크

구성

서버를 사용하려면 VSCode MCP 설정 파일을 구성해야 합니다. 다음은 구성 예시입니다.

{ "mcpServers": { "bitbucket": { "command": "node", "args": ["/path/to/bitbucket-server/build/index.js"], "env": { "BITBUCKET_URL": "https://your-bitbucket-server.com", // Authentication (choose one): // Option 1: Personal Access Token "BITBUCKET_TOKEN": "your-access-token", // Option 2: Username/Password "BITBUCKET_USERNAME": "your-username", "BITBUCKET_PASSWORD": "your-password", // Optional: Default project "BITBUCKET_DEFAULT_PROJECT": "your-default-project" } } } }

환경 변수

BITBUCKET_URL (필수): Bitbucket 서버 인스턴스의 기본 URL
인증(다음 중 하나가 필요합니다):
- BITBUCKET_TOKEN : 개인 액세스 토큰
- BITBUCKET_USERNAME 및 BITBUCKET_PASSWORD : 기본 인증 자격 증명
BITBUCKET_DEFAULT_PROJECT : 도구 호출에 지정되지 않은 경우 사용할 기본 프로젝트 키