What is Bitbucket Server Mcp

bitbucket-server-mcp is a Model Context Protocol (MCP) server designed for integration with Bitbucket Server. It provides tools for managing pull requests and automating code reviews.

Use cases

Use cases include automating code review processes, managing pull requests in large projects, integrating with CI/CD pipelines, and enhancing collaboration among development teams.

How to use

To use bitbucket-server-mcp, install the dependencies with ‘npm install’, configure your Bitbucket Server credentials in the ‘.env’ file, and start the server using ‘npm start’ or ‘node build/index.js’.

Key features

Key features include listing repositories, managing pull requests (create, merge, decline, delete), adding comments, getting pull request details and diffs, and handling tool wiring for the MCP protocol.

Where to use

bitbucket-server-mcp is primarily used in software development environments where Bitbucket Server is utilized for version control and collaborative coding, particularly in teams that require efficient pull request management.

Bitbucket Server MCP

A professional Model Context Protocol (MCP) server for Bitbucket Server, enabling seamless automation and integration for pull request management, code review, and repository operations.

Table of Contents

• Overview
• Features
• Installation
• Quick Start
• MCP Server Configuration
• Environment Variables
• Development
• Testing
• Contributing
• License

Overview

Bitbucket Server MCP provides a robust interface for automating and managing Bitbucket Server repositories and pull requests via the Model Context Protocol. Designed for enterprise environments, it supports advanced workflows, large diffs, and seamless integration with MCP clients.

Features

• List repositories, branches, and pull requests
• Create, update, and merge pull requests (merge-commit, squash, fast-forward)
• Decline and delete pull requests
• Add comments and inline code suggestions
• Retrieve pull request diffs and review status
• Efficient handling of large pull request diffs
• Extensible tool handler wiring for MCP protocol
• Cross-platform support (Windows, Mac, Linux)

Installation

Using npx (Recommended)

Run directly without cloning:

npx -y bitbucket-server-mcp

Local Installation

Clone and build the project:

git clone https://github.com/your-org/bitbucket-server-mcp.git
cd bitbucket-server-mcp
npm install
npm run build

Quick Start

1. Copy .env.example to .env and configure your Bitbucket Server credentials.

2. Start the MCP server:

   npm start
   # or
   node build/index.js
   

🚀 MCP Server Configuration

Add the following to your MCP configuration (e.g., cline_mcp_settings.json):

{
  "servers": [
    {
      "name": "bitbucket-server-mcp",
      "command": "npx",
      "args": [
        "-y",
        "bitbucket-server-mcp"
      ],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server",
        "BITBUCKET_TOKEN": "your-access-token",
        "BITBUCKET_DEFAULT_PROJECT": "your-default-project",
        "BITBUCKET_DEFAULT_REVIEWERS": "user1,user2"
      }
    }
  ]
}

Direct Node Usage

If npx is unavailable, configure as follows:

• Windows:

• Mac/Linux:

Environment Variables

See .env.example for details.

Development

• Lint code:

  npm run lint
  

• Run in watch mode:

  npm run dev
  

Testing

Run the test suite:

npm test

Contributing

Contributions are welcome! Please open issues or submit pull requests for new features, bug fixes, or improvements.

License

This project is licensed under the MIT License.