Mcp Server Wrapper Bitbucket

by vishn9893

286 downloads

Not rated

GitHub

Developer Tools

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

Author: vishn9893
Downloads: 286
Categories: Developer Tools

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 Bitbucket

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server wrapper bitbucket": {
            "mcp-server-wrapper-bitbucket": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "bitbucket-mcp-wrapper",
                    "."
                ]
            }
        }
    }
}

From the repository

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).

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

bash
pip install -r requirements.txt



2. Install & Build MCP Server (Node.js)

bash
npm install
npm run build

3. Start the FastAPI Server

bash
uvicorn app.main:app --reload

--- 🐳 Docker To run everything inside Docker:

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

--- 🌍 Environment Variables Set these to configure the Bitbucket MCP server:

env
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!

---

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

✅ README.md

🚀 Features

🧩 Endpoints

🧰 Requirements

🔧 Setup

1. Install Python dependencies

2. Install & Build MCP Server (Node.js)

3. Start the FastAPI Server

🐳 Docker

🌍 Environment Variables

Or use BITBUCKET_USERNAME + BITBUCKET_PASSWORD

📂 Project Structure

🧑‍💻 Maintainer

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

✅ `README.md`