Bitbucket Pipelines MCP Server

Bitbucket Pipelines MCP Server

site icon
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 流程的自动化管理。

核心功能

  1. 流水线管理
  2. 列出所有流水线(支持分页)
  3. 触发新的流水线
  4. 获取特定流水线的状态
  5. 停止正在运行的流水线

  6. 协议支持

  7. 实现 Model Context Protocol (MCP) 标准
  8. 使用 StdioServerTransport 进行通信(通过 stdin/stdout)

  9. 集成能力

  10. 可与 Cursor IDE 集成
  11. 提供 SDK 使用示例

适用场景

  1. 自动化 CI/CD 流程
  2. 语言模型辅助的代码部署
  3. 开发环境中的持续集成管理
  4. 团队协作中的流水线监控

工具列表

  1. mcp_bitbucket_list_pipelines - 列出流水线(支持分页)
  2. mcp_bitbucket_trigger_pipeline - 触发新流水线
  3. mcp_bitbucket_get_pipeline_status - 获取流水线状态
  4. mcp_bitbucket_stop_pipeline - 停止流水线

常见问题解答

  1. 如何配置访问权限?
  2. 需要设置 BITBUCKET_ACCESS_TOKEN、BITBUCKET_WORKSPACE 和 BITBUCKET_REPO_SLUG 环境变量

  3. 如何测试服务器是否正常运行?

  4. 可以使用提供的 docker-mcp-test.js 脚本进行测试

  5. 如何与 Cursor IDE 集成?

  6. 通过编辑 mcp.json 配置文件或创建单独的 mcp.config.json 文件

使用教程

使用依赖

  1. 需要安装 Docker 和 docker-compose(推荐方式)
  2. 或 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

调试方式

  1. 测试服务器状态:
chmod +x docker-mcp-test.js
node docker-mcp-test.js
  1. 手动调用工具示例:
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

许可证

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