Bitbucket Server MCP

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for managing Bitbucket Server pull requests, including creating, retrieving, merging, and declining PRs, adding comments, retrieving diffs, and managing reviews.

Bitbucket 서버 MCP

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

요구 사항

  • 노드.js >= 16

설치

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_USERNAMEBITBUCKET_PASSWORD : 기본 인증 자격 증명
  • BITBUCKET_DEFAULT_PROJECT : 도구 호출에 지정되지 않은 경우 사용할 기본 프로젝트 키

벌채 반출

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

MCP 프로토콜을 사용하여 풀 리퀘스트 관리를 위한 Bitbucket 서버와의 상호작용을 용이하게 하며, 풀 리퀘스트 생성, 병합, 주석 달기, 검토 등의 작업을 지원합니다.

  1. Requirements
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Build
      1. Features
        1. create_pull_request
        2. get_pull_request
        3. merge_pull_request
        4. decline_pull_request
        5. add_comment
        6. get_diff
        7. get_reviews
      2. Dependencies
        1. Configuration
          1. Environment Variables
        2. Logging
          ID: jskr5c1zq3