Mcp Server Wrapper Bitbucket
About
This is a MCP bridge for existing TypeScript Bitbucket MCP server in a Python UV-based API layer, essentially making UV act as a proxy/bridge.
Details
- License
- MIT
Explore
- Launches the MCP server (written in Node.js)
- Communicates over stdio for performance & flexibility
- Exposes clean REST endpoints via FastAPI
- Auto-generated OpenAPI docs
- Docker-ready
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp Server Wrapper BitbucketCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip install -r requirements.txt
npm install
npm run build
Set these to configure the Bitbucket MCP server:
```env
BITBUCKET_URL=https://your-bitbucket-server.com
BITBUCKET_TOKEN=your-access-token
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server wrapper bitbucket": {
"mcp-server-wrapper-bitbucket": {
"command": "docker",
"args": [
"build",
"-t",
"bitbucket-mcp-wrapper",
"."
]
}
}
}
}McpServers
{
"mcp-server-wrapper-bitbucket": {
"command": "docker",
"args": [
"build",
"-t",
"bitbucket-mcp-wrapper",
"."
]
}
}---
✅ README.md
# Bitbucket MCP Server - FastAPI Wrapper
This project is a Python-based FastAPI wrapper around a TypeScript MCP (Model Context Protocol) server for managing Bitbucket Server pull requests. It bridges the original MCP server with a modern HTTP/REST interface.
---
🚀 Features
- Launches the MCP server (written in Node.js)
- Communicates over stdio for performance & flexibility
- Exposes clean REST endpoints via FastAPI
- Auto-generated OpenAPI docs
- Docker-ready
---
🧩 Endpoints
| Method | Path | Description |
|--------|-------------------------|-----------------------------|
| POST | /create-pull-request | Create a new pull request |
| POST | /get-pull-request | Retrieve a PR's details |
| POST | /merge-pull-request | Merge a pull request |
| POST | /decline-pull-request| Decline a pull request |
| POST | /add-comment | Add comment to a PR |
| POST | /get-diff | Get diff of a pull request |
| POST | /get-reviews | Fetch review history |
| POST | /mcp | Direct MCP protocol access |
📘 Swagger UI available at: http://localhost:8000/docs
---
🧰 Requirements
- Python 3.10+
- Node.js 18+
- Bitbucket Server instance + token
- (Optional) Docker
---
🔧 Setup
1. Install Python dependencies
pip install -r requirements.txt
2. Install & Build MCP Server (Node.js)
npm install
npm run build
3. Start the FastAPI Server
uvicorn app.main:app --reload
---
🐳 Docker
To run everything inside Docker:
docker build -t bitbucket-mcp-wrapper .
docker run -p 8000:8000 bitbucket-mcp-wrapper
---
🌍 Environment Variables
Set these to configure the Bitbucket MCP server:
BITBUCKET_URL=https://your-bitbucket-server.com
BITBUCKET_TOKEN=your-access-token
Or use BITBUCKET_USERNAME + BITBUCKET_PASSWORD
---
📂 Project Structure
mcp_uv_wrapper/
├── app/
│ ├── main.py # FastAPI entry point
│ └── mcp_bridge.py # Communicates with MCP server
├── requirements.txt
└── Dockerfile
```
---
🧑💻 Maintainer
This wrapper was generated and managed via AI assistance.
Feel free to fork, open issues, or contribute!
---
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
