🚀 Bitbucket MCP 服务器 - FastAPI 包装器

本项目是一个基于 Python 的 FastAPI 工具，围绕用 TypeScript 编写的 Bitbucket Server 拉取请求管理 MCP（模型上下文协议）服务器构建。它的主要价值在于将原始的 MCP 服务器与现代 HTTP/REST 接口进行桥接，为开发者提供更便捷的操作体验。

🚀 快速开始

本项目旨在通过 FastAPI 包装器为 Bitbucket MCP 服务器提供现代 HTTP/REST 接口。以下是使用该项目的基本步骤：

1. 按照“🧰 要求”部分准备好所需的环境和依赖。
2. 依据“🔧 设置”部分的说明完成安装和配置。
3. 启动服务器后，可通过接口文档进行相应操作。

✨ 主要特性

• 启动 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 服务器进行交互，以下是部分接口的使用示例：

接口详情

📘 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、打开问题或贡献！