Bitbucket MCP Server - FastAPI 封装器

本项目是一个基于 Python 的 FastAPI 封装器，用于围绕 TypeScript MCP (模型上下文协议) 服务器管理 Bitbucket Server 的 pull request。它将原始 MCP 服务器与现代 HTTP/REST 接口桥接起来。

---

🚀 功能特性

• 启动 MCP 服务器 (使用 Node.js 编写)
• 通过 stdio 进行通信，以获得性能和灵活性
• 通过 FastAPI 公开简洁的 REST 端点
• 自动生成的 OpenAPI 文档
• Docker 就绪

---

🧩 端点

方法	路径	描述
POST	/create-pull-request	创建一个新的 pull request
POST	/get-pull-request	检索 PR 的详细信息
POST	/merge-pull-request	合并一个 pull request
POST	/decline-pull-request	拒绝一个 pull request
POST	/add-comment	向 PR 添加评论
POST	/get-diff	获取 pull request 的 diff
POST	/get-reviews	获取审查历史
POST	/mcp	直接 MCP 协议访问

📘 Swagger UI 可在以下地址访问: http://localhost:8000/docs

---

🧰 要求

• Python 3.10+
• Node.js 18+
• Bitbucket Server 实例 + token
• (可选) Docker

---

🔧 设置

1. 安装 Python 依赖

pip install -r requirements.txt

2. 安装 & 构建 MCP Server (Node.js)

npm install
npm run build

3. 启动 FastAPI Server

uvicorn app.main:app --reload

---

🐳 Docker

要在 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
# 或者使用 BITBUCKET_USERNAME + BITBUCKET_PASSWORD

---

📂 项目结构

mcp_uv_wrapper/
├── app/
│   ├── main.py         # FastAPI 入口点
│   └── mcp_bridge.py   # 与 MCP 服务器通信
├── requirements.txt
└── Dockerfile

---

🧑‍💻 维护者

此封装器由 AI 辅助生成和管理。 欢迎 fork, 提出 issue, 或贡献代码!