Mcp Server Wrapper Bitbucket
@vishn9893
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.
Overview
What is Mcp Server Wrapper Bitbucket?
Mcp Server Wrapper Bitbucket 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, exposing clean REST endpoints and auto-generated OpenAPI documentation.
How to use Mcp Server Wrapper Bitbucket?
Install Python dependencies with pip install -r requirements.txt, then install and build the Node.js MCP server with npm install && npm run build. Start the FastAPI server using uvicorn app.main:app --reload. Alternatively, run everything inside Docker with docker build -t bitbucket-mcp-wrapper . and docker run -p 8000:8000 bitbucket-mcp-wrapper. Configure the Bitbucket server URL and authentication via environment variables BITBUCKET_URL and BITBUCKET_TOKEN (or BITBUCKET_USERNAME + BITBUCKET_PASSWORD).
Key features of Mcp Server Wrapper Bitbucket
- Launches the MCP server (written in Node.js)
- Communicates over stdio for performance and flexibility
- Exposes clean REST endpoints via FastAPI
- Auto-generated OpenAPI docs (Swagger UI at
/docs) - Docker-ready for containerized deployment
Use cases of Mcp Server Wrapper Bitbucket
- Create, retrieve, merge, or decline Bitbucket pull requests via REST API
- Add comments to pull requests and retrieve diff or review history
- Integrate Bitbucket PR management into automated CI/CD pipelines
- Expose MCP protocol functionality to HTTP-based clients and tools
FAQ from Mcp Server Wrapper Bitbucket
What are the runtime requirements?
Python 3.10+, Node.js 18+, and a Bitbucket Server instance with an access token (or username/password).
How do I configure the server?
Set the environment variables BITBUCKET_URL (your Bitbucket server URL) and BITBUCKET_TOKEN (your access token). Alternatively, use BITBUCKET_USERNAME and BITBUCKET_PASSWORD.
What endpoints are available?
POST endpoints: /create-pull-request, /get-pull-request, /merge-pull-request, /decline-pull-request, /add-comment, /get-diff, /get-reviews, and /mcp for direct MCP protocol access.
Can I run it with Docker?
Yes. Build the image with docker build -t bitbucket-mcp-wrapper . and run it with docker run -p 8000:8000 bitbucket-mcp-wrapper.
What license is it under?
Apache 2.0.
