
Bitbucket Pipelines MCP Server

2025.04.13
0
TypeScriptCI/CD 工具Bitbucket 集成自动化部署开发效率
mcp_bitbucket_pipelines 是一个基于 Model Context Protocol (MCP) 的服务器,专门用于与 Bitbucket Pipelines 进行交互。它提供了一系列工具,允许语言模型(如 Claude)管理和操作 Bitbucket 的持续集成/持续部署 (CI/CD) 流水线。
View on GitHub
Overview
基本能力
产品定位
mcp_bitbucket_pipelines 是一个 MCP 服务器,旨在为语言模型提供与 Bitbucket Pipelines 交互的能力,实现 CI/CD 流程的自动化管理。
核心功能
- 流水线管理:
- 列出所有流水线(支持分页)
- 触发新的流水线
- 获取特定流水线的状态
-
停止正在运行的流水线
-
协议支持:
- 实现 Model Context Protocol (MCP) 标准
-
使用 StdioServerTransport 进行通信(通过 stdin/stdout)
-
集成能力:
- 可与 Cursor IDE 集成
- 提供 SDK 使用示例
适用场景
- 自动化 CI/CD 流程
- 语言模型辅助的代码部署
- 开发环境中的持续集成管理
- 团队协作中的流水线监控
工具列表
mcp_bitbucket_list_pipelines
- 列出流水线(支持分页)mcp_bitbucket_trigger_pipeline
- 触发新流水线mcp_bitbucket_get_pipeline_status
- 获取流水线状态mcp_bitbucket_stop_pipeline
- 停止流水线
常见问题解答
- 如何配置访问权限?
-
需要设置 BITBUCKET_ACCESS_TOKEN、BITBUCKET_WORKSPACE 和 BITBUCKET_REPO_SLUG 环境变量
-
如何测试服务器是否正常运行?
-
可以使用提供的 docker-mcp-test.js 脚本进行测试
-
如何与 Cursor IDE 集成?
- 通过编辑 mcp.json 配置文件或创建单独的 mcp.config.json 文件
使用教程
使用依赖
- 需要安装 Docker 和 docker-compose(推荐方式)
- 或 Node.js 环境(本地安装方式)
安装教程(Docker 方式)
git clone [url-do-repositorio]
cd bitbucket-pipelines-mcp
cp .env.example .env
# 编辑 .env 文件配置您的 Bitbucket 凭据
docker-compose up -d
安装教程(本地方式)
git clone [url-do-repositorio]
cd bitbucket-pipelines-mcp
npm install
cp .env.example .env
# 编辑 .env 文件配置您的 Bitbucket 凭据
npm run build
npm start
调试方式
- 测试服务器状态:
chmod +x docker-mcp-test.js
node docker-mcp-test.js
- 手动调用工具示例:
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"mcp_bitbucket_list_pipelines","input":{"page":1,"pagelen":5}}}' | docker exec -i bitbucket-pipelines-mcp_mcp-server_1 node dist/index.js