MCP (모델 Context Protocol) Bitbucket Server Pull Request 관리 서버. 이 서버는 MCP 프로토콜을 통해 Bitbucket Server API와 상호 작용하는 도구와 리소스를 제공합니다.

✨ 새로운 기능

• ** 맞춤 HTTP 헤더**: BITBUCKET_CUSTOM_HEADERS] 환경변수를 통해 모든 요청에 사용자 지정 헤더를 추가합니다 (제로 트러스트 토큰 또는 프록시에 사용) -T PR Discovery: [T1]] (fixes #14)를 사용하여 국가, 저자 또는 방향에 의한 목록 및 필터 풀 요청 -** 브랜치 관리**: list_branches]를 사용하여 기본 분기 탐지를 가진 목록 분지 delete_branch -❤️ Commit History: [T4]를 사용하여 분기 및 저자 필터링으로 Browse 커밋 내역
• ** ✅ PR 승인**: approve_pull_request] 및 unapprove_pull_request와 함께 풀 요청을 승인
• Advanced Search: search] 도구를 사용하여 프로젝트/리포지토리 필터링과 저장소의 검색 코드 및 파일 -s 파일 운영: 파일 내용을 읽고 get_file_content]과 browse_repository로 저장소 디렉토리를 검색 -** 코멘트 관리**: get_comments] 도구로 압축 및 필터 PR 코멘트

Bitbucket Server MCP

MCP (Model Context Protocol) server for Bitbucket Server Pull Request management. This server provides tools and resources to interact with the Bitbucket Server API through the MCP protocol.

✨ New Features

• 🔧 Custom HTTP Headers: Add custom headers to all requests via BITBUCKET_CUSTOM_HEADERS environment variable (useful for Zero Trust tokens or proxies)
• 📋 PR Discovery: List and filter pull requests by state, author, or direction using list_pull_requests (fixes #14)
• 🌿 Branch Management: List branches with default branch detection using list_branches, delete merged branches with delete_branch
• 📝 Commit History: Browse commit history with branch and author filtering using list_commits
• ✅ PR Approval: Approve and unapprove pull requests with approve_pull_request and unapprove_pull_request
• 🔍 Advanced Search: Search code and files across repositories with project/repository filtering using the search tool
• 📄 File Operations: Read file contents and browse repository directories with get_file_content and browse_repository
• 💬 Comment Management: Extract and filter PR comments with get_comments tool
• 🔍 Project Discovery: List all accessible Bitbucket projects with list_projects
• 📁 Repository Browsing: Explore repositories across projects with list_repositories
• 🔧 Flexible Project Support: Make the default project optional - specify per command or use BITBUCKET_DEFAULT_PROJECT
• 📖 Enhanced Documentation: Improved README with usage examples and better configuration guidance

Requirements

• Node.js >= 22

Installation

Installing via Smithery

To install Bitbucket Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

Installing via npm

The server is published on npm as @garc33/bitbucket-server-mcp-server. You can run it directly with npx:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@garc33/bitbucket-server-mcp-server"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token"
      }
    }
  }
}

Or install it globally and use the bitbucket-server-mcp command:

npm install -g @garc33/bitbucket-server-mcp-server

Manual Installation

npm install

Build

npm run build

Features