Bitbucket MCP Server Wrapper

The Bitbucket MCP Server Wrapper is a lightweight, Python‑centric gateway that exposes the full power of a TypeScript‑based Model Context Protocol (MCP) server through a modern FastAPI interface. It is designed for developers who need to programmatically interact with Bitbucket Server pull requests while leveraging the flexibility and performance of MCP. By running the original Node.js MCP server under a FastAPI wrapper, teams can consume pull‑request operations as RESTful endpoints without having to manage the MCP server directly in their workflow.

The wrapper solves a common pain point: integrating the rich, real‑time capabilities of MCP—such as direct protocol access and efficient stdio communication—into environments that favor HTTP APIs. With a single command, developers can start the FastAPI service, which internally launches the MCP server and keeps it alive in the background. The wrapper then forwards HTTP requests to the MCP process, translating them into protocol messages and returning structured responses. This approach eliminates the need for custom IPC setups while preserving the low‑latency benefits of stdio communication.

Key features include:

• RESTful endpoints for every pull‑request action: create, retrieve, merge, decline, comment, diff, and review history.
• Direct MCP access: a endpoint lets advanced users send arbitrary protocol messages for fine‑grained control.
• Auto‑generated OpenAPI documentation: Swagger UI is available out of the box, making exploration and testing effortless.
• Docker compatibility: a single image bundles Node.js, Python, and the MCP server, simplifying deployment in CI/CD pipelines or containerized environments.
• Environment‑driven configuration: Bitbucket URL and authentication tokens are supplied via environment variables, keeping secrets out of code.

In real‑world scenarios, this wrapper is invaluable for building CI/CD pipelines that need to programmatically approve or merge pull requests based on automated tests, code quality checks, or compliance rules. It also supports bot developers who want to listen for pull‑request events and respond with comments or status updates without embedding complex protocol logic into their applications. By bridging MCP and REST, the Bitbucket MCP Server Wrapper enables developers to harness powerful version‑control interactions while staying within familiar HTTP ecosystems.