MCP Server Wrapper Bitbucket

🚀 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、打開問題或貢獻！