MCP（模型上下文协议）服务器，用于Bitbucket服务器拉取请求管理。该服务器提供工具和资源，通过MCP协议与Bitbucket服务器API交互。

✨ 新功能

• ** 🔧 自定义 HTTP 头部：通过 BITBUCKET_CUSTOM_HEADERS 环境变量（对零信任令牌或代理有用）为所有请求添加自定义头部
• ** 📋 PR 发现**：按状态、作者或方向列表和过滤拉取请求，使用 list_pull_requests（修正 #14）
• ** 🌿 分支管理**：使用 list_branches 列出默认分支检测的分支，使用 delete_branch 删除合并的分支。
• ** 📝 提交历史**：使用[[T4]进行分支和作者筛选的提交历史。
• ** ✅ PR 批准**：通过 approve_pull_request 和 [unapprove_pull_request 批准和取消批准拉取请求。
• ** 🔍 高级搜索**：使用search工具通过项目/仓库过滤在仓库间搜索代码和文件
• ** 📄 文件操作**：读取文件内容并浏览存储库目录，使用 get_file_content 和 browse_repository
• ** 💬 评论管理**：使用 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