Bitbucket Server プルリクエスト管理用の MCP (Model Context Protocol) サーバー。 このサーバーは、MCP プロトコルを介して Bitbucket Server API とやり取りするためのツールとリソースを提供します。

✨ 新機能

-************ カスタムHTTPヘッダー**: [BITBUCKET_CUSTOM_HEADERS]を介してすべてのリクエストにカスタムヘッダを追加します。環境変数(ゼロトラストトークンまたはプロキシのために有用) -** PR Discovery**: list_pull_requests を使用して、状態、作者、または方向によるプルリクエストをリストおよびフィルタリングする (#14) -** ブランチ管理**: [list_branches] を使用してデフォルトのブランチ検出でブランチを一覧表示し、[delete_branch でマージブランチを削除します。 -Commit History: コミット履歴をブランチでブラウズし、[list_commitsを使用してフィルタリングします。

• ** PR承認**: approve_pull_requestと[[T6]でプルリクエストを承認し、承認しない -** 上級検索**: search ツールを使用して、プロジェクト/リポジトリフィルタリングでリポジトリ全体でコードとファイルを検索 -** ファイルのコンテンツを読み、リポジトリディレクトリを[get_file_contentと[[[T9]で参照] -コメント管理:[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