MCP Server Wrapper Bitbucket

🚀 Bitbucket MCP Server - FastAPI Wrapper

This project is a Python-based FastAPI device built around a Bitbucket Server pull request management MCP (Model Context Protocol) server written in TypeScript. It bridges the original MCP server with a modern HTTP/REST interface.

🚀 Quick Start

This project is a wrapper for the Bitbucket MCP server, which provides a RESTful API for managing pull requests in Bitbucket Server. It is built on top of FastAPI and uses Node.js to run the MCP server.

✨ Features

• Start the MCP server (written in Node.js).
• Communicate via stdio for improved performance and flexibility.
• Expose a clean REST interface through FastAPI.
• Automatically generate OpenAPI documentation.
• Ready for Docker deployment.

📦 Installation

Prerequisites

• Python 3.10+
• Node.js 18+
• Bitbucket Server instance + access token
• (Optional) Docker

Steps

1. Install Python dependencies

pip install -r requirements.txt

2. Install & build the MCP server (Node.js)

npm install
npm run build

3. Start the FastAPI server

uvicorn app.main:app --reload

💻 Usage Examples

Basic Usage

The wrapper provides a set of RESTful APIs for managing pull requests in Bitbucket Server. Here is a list of available endpoints:

📘 You can access the Swagger UI at: http://localhost:8000/docs

🐳 Docker

To run everything using Docker:

docker build -t bitbucket-mcp-wrapper .
docker run -p 8000:8000 bitbucket-mcp-wrapper

🌍 Environment Variables

Set the following variables to configure the Bitbucket MCP server:

BITBUCKET_URL=https://your-bitbucket-server.com
BITBUCKET_TOKEN=your-access-token
# Or use BITBUCKET_USERNAME + BITBUCKET_PASSWORD

📚 Documentation

Project Structure

mcp_uv_wrapper/
├── app/
│   ├── main.py         # FastAPI entry point
│   └── mcp_bridge.py   # Communicate with the MCP server
├── requirements.txt
└── Dockerfile

🧑💻 Maintainers

This wrapper is generated and managed with AI assistance.
Feel free to fork, open issues, or contribute!