Bitbucket MCP 서버

Bitbucket MCP는 Bitbucket Cloud API의 모든 기능을 자동화, CI/CD 파이프라인, 봇 및 Rust 기반 통합에 제공하는 고성능 상태 비저장(stateless) 서버입니다. 속도와 안정성을 위해 Rust로 구축된 Bitbucket MCP를 사용하면 개발자 도구, 워크플로우 자동화 또는 DevOps 솔루션을 구축할 때 Bitbucket 저장소, 풀 리퀘스트, 이슈 등을 안전하게 액세스하고 관리할 수 있습니다.

왜 Bitbucket MCP인가요?

• 원활한 Bitbucket API 통합: 최신 Rust 코드베이스를 사용하여 저장소, 풀 리퀘스트, 이슈, 브랜치, 파이프라인, 배포 등 모든 주요 Bitbucket Cloud 기능에 액세스하세요.

• 자동화 및 봇에 최적: Bitbucket을 모델 컨텍스트 프로토콜(MCP) 도구로 노출하여 봇, CI/CD 및 워크플로우 자동화에 이상적입니다.

• 기본적으로 안전함: TLS를 위해 rustls만 사용하며(OpenSSL 관련 문제 없음), Bitbucket API 토큰 인증을 지원합니다.

• Docker 준비 완료: GHCR의 사전 빌드된 Docker 이미지를 사용하여 어디서나 배포하거나 몇 분 만에 로컬에서 빌드하세요.

• 검증된 안정성: 포괄적인 테스트 제품군이 모든 공개 API 메서드를 다루어 통합의 안정성을 보장합니다.

Related MCP server: Bitbucket MCP Server

빠른 시작: Rust에서의 Bitbucket API 자동화

1. GHCR에서 사전 빌드된 Docker 이미지 사용

docker run -e BITBUCKET_API_USERNAME=<your_atlassian_email> -e BITBUCKET_API_TOKEN=<your_api_token> -p 8080:8080 ghcr.io/ibrahimogod/bitbucket-mcp:latest

• 모든 태그/릴리스 확인: GitHub Releases

• GHCR 패키지 참조

2. 로컬에서 빌드 및 실행 (Rust)

git clone https://github.com/Ibrahimogod/bitbucket-mcp.git
cd bitbucket-mcp
cargo build --release
$env:BITBUCKET_API_USERNAME="<your_atlassian_email>"
$env:BITBUCKET_API_TOKEN="<your_api_token>"
cargo run --release --bin bitbucket_stdio

지원되는 Bitbucket 작업 (MCP를 통해)

• 저장소, 워크스페이스, 풀 리퀘스트, 이슈, 브랜치, 태그, 커밋 나열 및 관리

• 저장소, 워크스페이스 및 사용자 세부 정보 가져오기

• 풀 리퀘스트 워크플로우 자동화: 생성, 업데이트, 승인, 거절, 병합, 댓글 작성 및 작업 관리

• Bitbucket 파이프라인, 배포, 다운로드, 웹훅, 스니펫 및 프로젝트와 통합

• 전체 API는 src/common/bitbucket.rs 참조

Bitbucket 인증

• 적절한 범위(예: repository:read, pullrequest:read)를 가진 Bitbucket API 토큰을 생성하세요.

• BITBUCKET_API_USERNAME을 Atlassian 이메일로 설정하세요.

• BITBUCKET_API_TOKEN을 API 토큰으로 설정하세요.

프로젝트 구조

• src/common/bitbucket.rs — Bitbucket API 통합 로직

• src/bitbucket_stdio.rs — 서버 진입점

• Cargo.toml — 의존성 구성 (rustls만 사용)

• Dockerfile — 다단계 빌드, OpenSSL 없음

• tests/bitbucket.rs — 모든 공개 API 메서드에 대한 전체 테스트 제품군

라이선스

MIT

Bitbucket MCP는 Rust, 봇 또는 CI/CD를 사용하여 Bitbucket Cloud를 자동화하는 가장 좋은 방법입니다. 저장소에 별을 누르고 오늘 바로 사용해 보세요!

예시: Docker 통합을 위한 VS Code MCP 설정

VS Code MCP 확장을 구성하여 Docker를 사용하여 Bitbucket MCP 서버를 자동으로 시작할 수 있습니다. .vscode/settings.json(또는 전역 MCP 설정 파일)에 다음을 추가하세요:

{
  "mcp": {
    "servers": {
      "bitbucket-mcp-docker": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "-e", "BITBUCKET_API_USERNAME",
          "-e", "BITBUCKET_API_TOKEN",
          "-e", "RUST_BACKTRACE",
          "ghcr.io/ibrahimogod/bitbucket-mcp:latest"
        ],
        "env": {
          "BITBUCKET_API_USERNAME": "<your_atlassian_email>",
          "BITBUCKET_API_TOKEN": "<your_api_token>",
          "RUST_BACKTRACE": "1"
        }
      }
    }
  }
}

<your_atlassian_email>과 <your_api_token>을 본인의 Bitbucket 자격 증명으로 바꾸세요. 필요한 경우 latest 대신 특정 이미지 태그를 지정할 수도 있습니다.

이 구성을 사용하면 VS Code에서 Bitbucket 도구를 사용할 때 MCP 확장이 Docker에서 Bitbucket MCP 서버를 자동으로 시작할 수 있습니다.

예시: Docker 통합을 위한 Cursor MCP 설정

Cursor를 구성하여 Docker를 사용하여 Bitbucket MCP 서버를 자동으로 시작할 수 있습니다. .cursor/mcp.json(프로젝트용) 또는 ~/.cursor/mcp.json(전역 사용)에 다음을 추가하세요:

{
  "mcpServers": {
    "bitbucket-mcp-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e", "BITBUCKET_API_USERNAME",
        "-e", "BITBUCKET_API_TOKEN",
        "-e", "RUST_BACKTRACE",
        "ghcr.io/ibrahimogod/bitbucket-mcp:latest"
      ],
      "env": {
        "BITBUCKET_API_USERNAME": "<your_atlassian_email>",
        "BITBUCKET_API_TOKEN": "<your_api_token>",
        "RUST_BACKTRACE": "1"
      }
    }
  }
}

<your_atlassian_email>과 <your_api_token>을 본인의 Bitbucket 자격 증명으로 바꾸세요. 필요한 경우 latest 대신 특정 이미지 태그를 지정할 수도 있습니다.

이 구성을 사용하면 Bitbucket 도구를 사용할 때 Cursor가 Docker에서 Bitbucket MCP 서버를 자동으로 시작할 수 있습니다.