Atlassian Bitbucket Server MCP

An MCP server that integrates Atlassian Bitbucket with AI systems, providing API functions such as code repository access and PR operations

Version control Developer tools #Bitbucket integration #AI collaboration #Code management #API service Remote .TypeScript

rating : 2 points

downloads : 8.9K

update time : 2025-04-28

Open Site

What is Bitbucket MCP Server?

This is a middleware service specifically designed for AI systems, allowing AI to securely access and operate code repositories in Bitbucket Server/Data Center. It acts like an interpreter between AI and the code repository, converting AI requests into instructions that Bitbucket can understand.

How to use this service?

You only need to configure the Bitbucket server address and access token, and then start the service through a simple command line or Docker container. The AI system can interact with the service through standard input/output or HTTP interfaces.

Use cases

Suitable for scenarios that require AI-assisted code review, automatic generation of commit messages, intelligent merge conflict resolution, etc. It is also suitable for building Q&A systems or document generation tools based on code repositories.

Main features

Code repository access

Provides full access capabilities at the project, repository, branch, and file levels, supporting content retrieval and metadata query

Pull Request tools

Supports creating, viewing, commenting on, and merging Pull Requests, enabling automated code review

Type-safe API

A type-safe interface generated based on the official Bitbucket OpenAPI specification, reducing integration errors

Multi-transport protocol support

Supports both STDIO and HTTP/SSE communication methods simultaneously to meet the integration needs of different AI systems

Advantages

Standardized interface: Provides a unified access mode, simplifying the integration of AI systems with code repositories

Security isolation: As an intermediate service, it prevents AI systems from directly accessing code repository credentials

Flexible deployment: Supports local operation and Docker containerization deployment

Performance optimization: Optimized API response structure for AI scenarios

Limitations

Only supports Atlassian Bitbucket Server/Data Center, not the cloud version

Requires pre-configured valid access tokens

Performance tuning may be required for large-scale repository operations

How to use

Prepare the environment

Ensure that Node.js (v20+), npm, and Python3 environments are installed

Get the Bitbucket access token

Create an access token with appropriate permissions in the Bitbucket server settings

Install the service

Clone the repository and install dependencies

Configure environment variables

Set the Bitbucket server address and access token

Start the service

Select a suitable transport protocol to start the service

Usage examples

Automated code review

The AI system automatically analyzes newly committed code, checks coding standards, and provides improvement suggestions

Intelligent merge conflict resolution

When a merge conflict occurs in a Pull Request, the AI suggests possible solutions

Code repository Q&A system

Answer developers' questions based on the content of the code repository

Frequently Asked Questions

Does this service support Bitbucket Cloud?

What permissions are required for the access token?

How to monitor the service running status?

Does it support enterprise-level deployment?

Related resources

GitHub repository

Project source code and the latest version

Bitbucket REST API documentation

Official API reference documentation

MCP protocol specification

Official specification of the Model Context Protocol

🚀 Atlassian Bitbucket MCP Server

A Model Context Protocol (MCP) server for Atlassian Bitbucket Server/Data Center integrated with AI systems.

🚀 Quick Start

This server enables AI systems to interact with Bitbucket repositories in the following ways:

Access projects, repositories, branches, and files.
Provide tools for handling pull requests.
Implement type-safe API integration using the official Bitbucket OpenAPI specification.

Prerequisites

Node.js (v20+ recommended)
npm
Python 3 (for the OpenAPI filtering script)
Bitbucket Server access token

Installation

git clone [<atlassian-bitbucket-server-mcp>](https://github.com/guenichone/atlassian-bitbucket-server-mcp)  
cd mcp-server-selfhosted-bitbucket  
npm install  
npm run build-app

Running the Server

# As an STDIO server (default option for AI integration)
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \  
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \  
npm start  

# As an HTTP/SSE server
MCP_TRANSPORT=sse \  
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \  
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \  
npm start

✨ Features

This server allows AI systems to interact with Bitbucket repositories through the following methods:

Access projects, repositories, branches, and files.
Provide tools for handling pull requests.
Implement type-safe API integration using the official Bitbucket OpenAPI specification.

📦 Installation

Using Docker CLI

# Build
docker build -t bitbucket-mcp-server .  

# Run
docker run --rm -i \  
  -e ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \  
  -e ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \  
  bitbucket-mcp-server

Using Makefile (Recommended)

This project includes a Makefile to simplify Docker operations:

# Build the Docker image
make docker-build  

# Run with your Bitbucket credentials
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-run  

# Build and run at once
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-all  

# View all available Make commands and examples
make help

📚 Documentation

Environment Variables

Property	Details
`ATLASSIAN_BITBUCKET_SERVER_URL`	Bitbucket server URL
`ATLASSIAN_BITBUCKET_ACCESS_TOKEN`	Your access token
`MCP_TRANSPORT`	`stdio` (default) or `sse`
`PORT`	HTTP port when using SSE (default: 3000)