Wrapper Bitbucket

______________________________________________________________________

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

![FastAPI](https://img.shields.io/badge/FastAPI-API-green.svg)

![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)

---

## 🚀 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](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.安装并构建MCP服务器（Node.js）

npm install npm run build

### 3.启动FastAPI服务器

uvicorn app.main:app --reload

______________________________________________________________________

## 🐳 码头工人

要在Docker中运行所有内容：

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

______________________________________________________________________

## 🌍 环境变量

设置这些以配置Bitbucket MCP服务器：

BITBUCKET_URL=https://your-bitbucket-server.com BITBUCKET_TOKEN=your-access-token

Or use BITBUCKET_USERNAME + BITBUCKET_PASSWORD

______________________________________________________________________

## 📂 项目结构

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

______________________________________________________________________

## 🧑‍💻 维护者

此包装是通过人工智能辅助生成和管理的。\
请随意分叉、打开问题或贡献！

______________________________________________________________________