🚀 Bitbucket MCP 服务器 - FastAPI 包装器
本项目是一个基于 Python 的 FastAPI 工具，围绕用 TypeScript 编写的 Bitbucket Server 拉取请求管理 MCP（模型上下文协议）服务器构建。它的主要价值在于将原始的 MCP 服务器与现代 HTTP/REST 接口进行桥接，为开发者提供更便捷的操作体验。
🚀 快速开始
本项目旨在通过 FastAPI 包装器为 Bitbucket MCP 服务器提供现代 HTTP/REST 接口。以下是使用该项目的基本步骤：
- 按照“🧰 要求”部分准备好所需的环境和依赖。
- 依据“🔧 设置”部分的说明完成安装和配置。
- 启动服务器后，可通过接口文档进行相应操作。
✨ 主要特性
- 启动 MCP 服务器：使用 Node.js 编写的 MCP 服务器可顺利启动。
- 高效通信：通过 stdio 进行通信，提升性能和灵活性。
- 简洁接口：借助 FastAPI 暴露干净的 REST 接口。
- 自动文档生成：能自动生成 OpenAPI 文档。
- Docker 支持：支持使用 Docker 运行项目。
📦 安装指南
安装要求
- Python 3.10+
- Node.js 18+
- Bitbucket Server 实例 + 访问令牌
- （可选）Docker
安装步骤
1. 安装 Python 依赖
pip install -r requirements.txt
2. 安装 & 构建 MCP 服务器（Node.js）
npm install
npm run build
3. 启动 FastAPI 服务器
uvicorn app.main:app --reload
Docker 安装
要使用 Docker 运行所有内容：
docker build -t bitbucket-mcp-wrapper .
docker run -p 8000:8000 bitbucket-mcp-wrapper
💻 使用示例
基础用法
本项目提供了一系列接口用于与 Bitbucket MCP 服务器进行交互，以下是部分接口的使用示例：
接口详情
| 方法 | 路径 | 描述 |
|---|---|---|
| POST | /create-pull-request |
创建新的拉取请求 |
| POST | /get-pull-request |
获取 PR 的详细信息 |
| POST | /merge-pull-request |
合并拉取请求 |
| POST | /decline-pull-request |
拒绝拉取请求 |
| POST | /add-comment |
在 PR 上添加评论 |
| POST | /get-diff |
获取拉取请求的差异 |
| POST | /get-reviews |
获取审查历史记录 |
| POST | /mcp |
直接访问 MCP 协议 |
📘 Swagger UI 可在以下地址访问：http://localhost:8000/docs
🌍 环境变量
设置以下变量以配置 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、打开问题或贡献！