Bitbucket Server MCP

Bitbucket 서버 MCP

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

요구 사항

• 노드.js >= 16

설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

짓다

특징

이 서버는 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 설정 파일을 구성해야 합니다. 다음은 구성 예시입니다.

환경 변수

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

벌채 반출

서버는 디버깅 및 모니터링 목적으로 Winston을 사용하여 모든 작업을 bitbucket.log 에 기록합니다.