MCP (Model Context Protocol) сервер для управления запросами Bitbucket Server Pull. Этот сервер предоставляет инструменты и ресурсы для взаимодействия с Bitbucket Server API через протокол MCP.

Новые возможности

** * Пользовательские HTTP-заголовки**: Добавьте пользовательские заголовки ко всем запросам через переменную среды BITBUCKET_CUSTOM_HEADERS (полезно для токенов Zero Trust или прокси) ** PR Discovery**: запросы на вытягивание списка и фильтра по состоянию, автору или направлению с использованием list_pull_requests (фиксы #14) ** ] Управление филиалами**: Перечислите филиалы с обнаружением филиалов по умолчанию с использованием list_branches, удалите объединенные филиалы с delete_branch ** * * * Совершите историю * : Просмотрите историю с ветвью и фильтрацией автора с помощью list_commits ** ] PR Approval*: Утвердить и не утвердить запросы на вытягивание approve_pull_request и unapprove_pull_request *** Расширенный поиск**: Поисковый код и файлы в репозиториях с фильтрацией проектов/репозиториев с помощью инструмента search ** ] Операции с файлами**: Прочитайте содержимое файлов и просмотрите каталоги репозиторий с get_file_content и browse_repository Управление комментариями **: извлекать и фильтровать PR-комментарии с помощью инструмента get_comments

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