JishadMT/bitbucket-mcp

MCP Bitbucket Review Server

This is an MCP server for LLMs to use capabilities of bitbucket to it's code review workflows.

Installation

[!IMPORTANT]
You need python 3.10 or above for this to work.

Install from pip:

pip install mcp-bitbucket-review

Configuration in Cursor

1. Go to File -> Preferences -> Cursor Settings -> MCP & Integrations.

2. Add a new MCP server.

3. Add the bitbucket server MCP from the following to the mcpServers object of mcp.json:

   {
       "mcpServers": {
           // ... your rest of the MCP servers
           "bitbucket": {
               "command": "mcp-bitbucket-review-server",
               "env": {
                   "BITBUCKET_EMAIL": "YOUR_BITBUCKET_EMAIL",
                   "BITBUCKET_API_TOKEN": "YOUR_BITBUCKET_API_TOKEN"
               }
           }
       }
   }
   
   

4. Save the settings.

Usage sample

Open new chat and give following prompt:

Review pull request <YOUR_PULL_REQUEST_URL>

Code Review Checklist

You can provide a custom code review checklist to be used during the review process. The checklist is read from a file and can have both general guidelines and guidelines specific to each repository.

Checklist file structure

The checklist file is a plain text file with sections for each repository. A section starts with the repository name in square brackets (e.g., [my-repo]). A special section named [general] can be used for guidelines that apply to all repositories.

Here is an example of a checklist file:

[general]
Ensure code is well-documented.
Check for any commented-out code that should be removed.

[my-awesome-repo]
Follow the "Awesome Repo" coding style.
Make sure to update the `awesome-spec.json` file.

[another-repo]
All new features must be covered by integration tests.

Configuration

To use the checklist, you need to set the BITBUCKET_CODE_REVIEW_CHECKLIST environment variable to the absolute path of your checklist file.

You can add this to your mcp.json configuration file:

{
    "mcpServers": {
        // ... your rest of the MCP servers
        "bitbucket": {
            "command": "mcp-bitbucket-review-server",
            "env": {
                // ... other environment variables
                "BITBUCKET_CODE_REVIEW_CHECKLIST": "C:\\path\\to\\your\\checklist.txt"
            }
        }
    }
}

Get API token from bitbucket

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens

2. Click on button labelled Create API token with scopes

3. Give scopes and store the API token. Make sure you give the following scopes to the API token:

   read:pullrequest:bitbucket
   write:pullrequest:bitbucket
   read:repository:bitbucket
   

Happy coding!