MCP Bitbucket Python 🦊
Bitbucket 통합을 위한 MCP 서버의 Python 구현입니다. MCP(Model Context Protocol)는 AI 애플리케이션에 대한 안전한 로컬 도구 액세스를 지원합니다. 이 서버는 AI 애플리케이션과 동일한 머신에서 로컬로 실행됩니다.
설치
지엑스피1
사용 가능한 도구
이 MCP 서버는 다음과 같은 Bitbucket 통합 도구를 제공합니다.
bb_create_repository
: 새로운 Bitbucket 저장소를 만듭니다.- 필수: name(저장소 이름)
- 선택 사항: 설명, 작업 공간(기본값은 kallows), project_key, is_private(기본값: true), has_issues(기본값: true)
bb_create_branch
: 저장소에 새로운 브랜치를 생성합니다.- 필수: repo_slug, branch(새 브랜치의 이름)
- 선택 사항: 작업 공간(기본값은 kallows), 시작점(기본값은 main)
bb_delete_repository
: Bitbucket 저장소 삭제- 필수: repo_slug
- 선택 사항: 작업 공간(기본값은 kallows)
bb_read_file
: 저장소에서 파일을 읽습니다.- 필수: repo_slug, path(저장소의 파일 경로)
- 선택 사항: 작업 공간(기본값은 kallows), 지점(기본값은 main/master)
bb_write_file
: 저장소에 파일을 생성하거나 업데이트합니다.- 필수: repo_slug, 경로, 콘텐츠
- 선택 사항: 작업 공간(기본값은 kallows), 분기(기본값은 main), 메시지(커밋 메시지)
bb_create_issue
: 저장소에 이슈를 생성합니다.- 필수: repo_slug, title, content
- 선택 사항: 작업 공간(기본값은 kallows), 종류(버그/개선/제안/작업), 우선순위(사소한/중요한/중요한/중요한/차단)
bb_delete_issue
: 저장소에서 이슈를 삭제합니다.- 필수: repo_slug, issue_id
- 선택 사항: 작업 공간(기본값은 kallows)
bb_search_repositories
: 쿼리 구문을 사용하여 Bitbucket 저장소 검색- 필수: 쿼리(예: 'name ~ "test"' 또는 'project.key = "PROJ"')
- 선택 사항: 작업 공간(기본값은 kallows), 페이지(기본값: 1), 페이지 길이(기본값: 10, 최대값: 100)
bb_delete_file
: 저장소에서 파일을 삭제합니다.- 필수: repo_slug, 경로
- 선택 사항: 작업 공간(기본값은 kallows), 분기(기본값은 main), 메시지(커밋 메시지)
bb_create_pull_request
: 풀 리퀘스트 생성- 필수: repo_slug, title, source_branch
- 선택 사항: 작업 공간(기본값은 kallows), destination_branch(기본값은 main), 설명, close_source_branch(기본값: true)
환경 설정
서버에는 Bitbucket 자격 증명을 환경 변수로 설정해야 합니다.
export BITBUCKET_USERNAME="your-username"
export BITBUCKET_APP_PASSWORD="your-app-password"
프로젝트 구조
mcp-bitbucket/
├── README.md
├── pyproject.toml
├── src/
│ └── bitbucket_api/
│ ├── __init__.py
│ └── server.py
└── tests/
├── __init__.py
├── test_bb_api.py
└── test_bb_integration.py