Bitbucket Server MCP

What is Bitbucket Server MCP?

Bitbucket Server MCP is a Model Context Protocol server that provides tools and resources for managing Bitbucket Server pull requests through the MCP protocol, enabling AI assistants to interact with Bitbucket Server’s API.

How to use Bitbucket Server MCP?

Install Node.js >= 16, run npm install and npm run build, then configure the server in your MCP client’s settings file with the required environment variables (BITBUCKET_URL and either BITBUCKET_TOKEN or BITBUCKET_USERNAME/BITBUCKET_PASSWORD). Invoke it by running the built index.js with node.

Key features of Bitbucket Server MCP

• Create, retrieve, merge, and decline pull requests.
• Add comments and replies to pull requests.
• Retrieve diffs with configurable context lines.
• Fetch review history and approvals.
• Supports both token and basic authentication.

Use cases of Bitbucket Server MCP

• Automate pull request creation and review workflows.
• Retrieve detailed PR information for code review summaries.
• Merge or decline pull requests based on AI analysis.
• Add automated comments for code quality checks.

FAQ from Bitbucket Server MCP

What is the Bitbucket Server MCP server?

It is an MCP server that exposes Bitbucket Server pull request management tools to MCP-compatible clients.

How do I authenticate to Bitbucket Server?

Set either BITBUCKET_TOKEN (personal access token) or BITBUCKET_USERNAME and BITBUCKET_PASSWORD (basic auth) in environment variables.

What tools are provided?

Eight tools: create_pull_request, get_pull_request, merge_pull_request, decline_pull_request, add_comment, get_diff, get_reviews, and configuration via environment.

What dependencies are required?

Node.js >= 16, plus @modelcontextprotocol/sdk, axios, and winston.

Where are logs stored?

Logs are written to a file named bitbucket.log in the working directory.