Bitbucket MCP Server - FastAPI Wrapper

Bitbucket MCP Server - FastAPI Wrapper

site icon
2025.04.12 0
PythonBitbucket Server拉取请求管理FastAPIREST接口交流协作开发效率
Bitbucket MCP Server - FastAPI Wrapper 是一个基于Python的FastAPI封装器,用于管理Bitbucket Server的拉取请求(Pull Requests)。它通过现代HTTP/REST接口桥接原始的MCP(Model Context Protocol)服务器,提供高性能和灵活性的通信方式。
View on GitHub

Overview

基本能力

产品定位

该服务主要用于Bitbucket Server的拉取请求管理,通过FastAPI提供REST接口,简化与MCP服务器的交互。

核心功能

  • 启动MCP服务器(基于Node.js)
  • 通过stdio进行高性能和灵活的通信
  • 通过FastAPI暴露干净的REST端点
  • 自动生成的OpenAPI文档
  • 支持Docker部署

适用场景

  • 需要自动化管理Bitbucket Server拉取请求的开发团队
  • 需要与Bitbucket Server进行高效通信的CI/CD流程
  • 需要REST接口与MCP服务器交互的应用

工具列表

  • FastAPI: 提供REST接口和自动生成的OpenAPI文档
  • Node.js: 运行MCP服务器
  • Docker: 支持容器化部署

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

  • Python 3.10+
  • Node.js 18+
  • Bitbucket Server实例及访问令牌
  • (可选)Docker

安装教程

  1. 安装Python依赖
pip install -r requirements.txt
  1. 安装并构建MCP服务器(Node.js)
npm install
npm run build
  1. 启动FastAPI服务器
uvicorn app.main:app --reload

调试方式

启动FastAPI服务器后,可以通过访问Swagger UI进行调试:

http://localhost:8000/docs

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。