Provides tools for interacting with Bitbucket repositories, with a primary focus on retrieving pull request context and facilitating automated code reviews.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bitbucket MCP Serverreview the latest pull request in the frontend repository"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🌬️ bitbucket-mcp-server
Simple MCP implementation for (mostly) pull requests on Bitbucket.
Provide context from your PRs to your favorite LLM and let it review them for you!
Written in Bun and Civet using Cursor as an assistant.
Read the documentation here.
🚧 This repository is a MCP learning exercise and it is still work in progress.
The API here lacks many features as of now. More features might be added in the near future.
Also, the documentation was written by Cursor itself. Don't expect it to be perfect. 🚧
Install
First clone this repository somewhere you'd like.
Then there are 2 ways to run it locally:
If you want to download and use the release version, you can run via the binary available in this repository ;
Otherwise, you'll have to either build from scratch, or install Bun and run the
index.civetfile directly.
Release
To run from the pre-built binaries, go to the page and get the latest release from there.
Extract the binary somewhere you'd like.
Then, add this to your MCP servers settings:
This is enough to get the server going.
Bun/Build
If you want to run with Bun (or build with it), you'll first need to install bun by running:
Then from the project directory install all dependencies with:
Running with Bun
To run with bun directly, add this entry to your MCP servers settings:
Building
Run the build command from the project root directory:
This will output a binary in the dist/ folder to whatever architecture you're using.
Then follow the same steps from the Release option to add the MCP server to your settings.
Development
Make sure you have both Bun's runtime and Civet's VSCode/Cursor extension installed.
Then after cloning the repository, install its dependencies:
The best way to visualize everything working is by running:
This will open the MCP Inspector with a GUI to play around and explore the MCP tools.
MCP tools limitation
MCP has a limitation of 40 tools that will be sent to the agent.
Currently bitbucket-mcp-server provides 24 tools total. Consider disabling the ones you don't use often to save some slots.
To do
Maybe implement OAuth
This project was created using bun init in bun v1.2.17. Bun is a fast all-in-one JavaScript runtime.