Bitbucket Server MCP

What is Bitbucket Server MCP?

Bitbucket Server MCP is a Model Context Protocol (MCP) server that provides tools and resources to interact with the Bitbucket Server API for pull request management. It is designed for developers who need to manage Bitbucket Server pull requests through MCP‑compatible clients.

How to use Bitbucket Server MCP?

Install the server via Smithery or manually, then build it with npm run build. Configure it in your MCP client settings (e.g., VSCode MCP settings file) by setting required environment variables (BITBUCKET_URL, authentication) and optionally default project/repository. Once running, the MCP client can call the provided tools to manage pull requests and related operations.

Key features of Bitbucket Server MCP

• Create, retrieve, merge, and decline pull requests
• Add comments to pull requests
• Retrieve pull request diffs and review history
• Push multiple files in a single commit to a branch
• Support for personal access token or username/password authentication
• Configurable default project and repository keys

Use cases of Bitbucket Server MCP

• Automating pull request creation from CI/CD pipelines
• Reviewing and merging pull requests without leaving the MCP client
• Adding comments or declining pull requests programmatically
• Fetching diffs or review history for code inspection
• Pushing file changes directly from a conversational AI interface

FAQ from Bitbucket Server MCP

What Node.js version is required?

Node.js version 16 or higher is required.

What authentication options are available?

You can authenticate using either a personal access token (BITBUCKET_TOKEN) or basic authentication with username and password (BITBUCKET_USERNAME and BITBUCKET_PASSWORD).

How is the server configured?

Configuration is done via environment variables in your MCP client settings. BITBUCKET_URL is required, along with one of the two authentication methods. Optionally, BITBUCKET_DEFAULT_PROJECT and BITBUCKET_DEFAULT_REPOSITORY can be set to avoid repeating those parameters in every tool call.

Where are logs stored?

The server logs all operations to a file named bitbucket.log using the Winston logging framework.

How do I install Bitbucket Server MCP?

You can install it via Smithery: npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude, or manually by cloning the repository and running npm install followed by npm run build.