Bitbucket Server MCP Server

The MCP protocol service for Bitbucket Server, providing Pull Request management functions

Version control Developer tools #Code Review #Version Control #PR Management #Bitbucket Remote .TypeScript

rating : 2.5 points

downloads : 29

update time : 2025-04-29

What is the Bitbucket Server MCP Server?

The Bitbucket Server MCP Server is a tool specifically designed for Bitbucket Server. It provides comprehensive management capabilities for Pull Requests through the Model Context Protocol (MCP), including creating, merging, commenting, and getting differences.

How to use the Bitbucket Server MCP Server?

Simply set the environment variables according to the configuration steps and then use the provided API interfaces to easily operate Pull Requests in Bitbucket Server.

Applicable Scenarios

Suitable for enterprise teams that need to efficiently manage Bitbucket Server Pull Requests, especially developers who want to automate processes and improve collaboration efficiency.

Main Features

Create a Pull RequestSupports quickly creating a new Pull Request by specifying information such as the project, repository, and branch.

Get Pull Request DetailsGet detailed information about a Pull Request based on its ID.

Merge a Pull RequestSupports multiple merge strategies (such as Merge Commit, Squash, Fast Forward) to complete the merge of a Pull Request with one click.

Add a CommentAdd comments or replies to a Pull Request to promote team communication.

Get DifferencesView the specific code changes involved in a Pull Request.

Get Review HistoryTrack the approval records and feedback of a Pull Request.

Advantages and Limitations

Advantages

Simplify the management process of Bitbucket Server Pull Requests.

Support multiple merge strategies to meet the needs of different teams.

Provide rich API interfaces for easy integration with other systems.

Reduce the cost of manual operations and improve work efficiency.

Limitations

Depend on the availability of the Bitbucket Server instance.

Require correct configuration of environment variables to work properly.

Some advanced features may require additional permission settings.

How to Use

Install Dependencies

Ensure that Node.js version 16 or higher is installed and run `npm install` to install the required dependencies.

Configure Environment Variables

Configure the relevant information of Bitbucket Server in the VSCode MCP settings file, such as the URL, Token, or username and password.

Start the Server

After running `npm run build` to build the project, execute `npm start` to start the server.

Usage Examples

Create a Pull RequestQuickly create a new Pull Request by specifying information such as the project, repository, and branch.

Get Pull Request DetailsGet detailed information about a Pull Request based on its ID.

Frequently Asked Questions

How to configure the access credentials for Bitbucket Server?

How to check if the server is running properly?

Does it support customizing the default project?

Related Resources

Official Documentation

The official documentation for the Bitbucket Server MCP Server.

GitHub Repository

The address of the source code repository.

🚀 Bitbucket Server MCP

The MCP (Model Context Protocol) server is used to manage pull requests on Bitbucket Server. This server provides tools and resources to interact with the Bitbucket Server API via the MCP protocol.

🚀 Quick Start

Requirements

Node.js >= 16

Installation

Install via Smithery

To automatically install the Bitbucket Server for Claude Desktop, use Smithery:

npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude

Manual Installation

npm install

Build

npm run build

✨ Features

This server provides the following tools for Bitbucket Server integration:

`create_pull_request`

Create a new pull request.

Parameters:

project: Bitbucket project key (default is BITBUCKET_DEFAULT_PROJECT if set)
repository (required): Repository alias
title (required): PR title
description: PR description
sourceBranch (required): Source branch name
targetBranch (required): Target branch name
reviewers: Array of reviewer usernames

`get_pull_request`

Get detailed information about a specific pull request.

Parameters:

project: Bitbucket project key (default is BITBUCKET_DEFAULT_PROJECT if set)
repository (required): Repository alias
prId (required): Pull request ID

`merge_pull_request`

Merge a pull request.

Parameters:

project: Bitbucket project key (default is BITBUCKET_DEFAULT_PROJECT if set)
repository (required): Repository alias
prId (required): Pull request ID
message: Merge commit message
strategy: One of:
- merge-commit (default)
- squash
- fast-forward

`decline_pull_request`

Decline a pull request.

Parameters:

project: Bitbucket project key (default is BITBUCKET_DEFAULT_PROJECT if set)
repository (required): Repository alias
prId (required): Pull request ID
message: Reason for decline

`add_comment`

Add a comment to a pull request.

Parameters:

project: Bitbucket project key (default is BITBUCKET_DEFAULT_PROJECT if set)
repository (required): Repository alias
prId (required): Pull request ID
text (required): Comment text
parentId: ID of the parent comment for replies

`get_diff`

Get the diff of a pull request.

Parameters:

project: Bitbucket project key (default is BITBUCKET_DEFAULT_PROJECT if set)
repository (required): Repository alias
prId (required): Pull request ID

📚 Documentation

Third - Party Libraries

This server depends on the following third - party libraries:

@smithery/cli - Smithery CLI tool for tool installation and management
axios - Promise - based HTTP client
winston - Lightweight logging library

Configuration

Environment Variables

This server uses the following environment variables:

Property	Details
`BITBUCKET_SERVER_URL`	URL address of the Bitbucket Server (default is `http://localhost:7990`)
`BITBUCKET_USERNAME` and `BITBUCKET_PASSWORD`	Username and password for authentication
`BITBUCKET_DEFAULT_PROJECT`	Default project key used when not specified