Bitbucket Server MCP

Bitbucket Server MCP

面向 Bitbucket Server 的专业模型上下文协议（MCP）服务，可无缝自动化和集成拉取请求管理、代码评审和仓库操作。

---

目录

• 概览
• 功能
• 安装
• 快速开始
• MCP 服务配置
• 环境变量
• 开发
• 测试
• 贡献
• 许可证

---

概览

Bitbucket Server MCP 通过模型上下文协议，为自动化管理 Bitbucket Server 仓库和拉取请求提供可靠的接口。它专为企业环境设计，支持高级工作流、大型差异内容，以及与 MCP 客户端无缝集成。

---

功能

• 列出仓库、分支和拉取请求
• 创建、更新和合并拉取请求（合并提交、压缩、快进）
• 拒绝和删除拉取请求
• 添加评论和行内代码建议
• 获取拉取请求差异内容和评审状态
• 高效处理大型拉取请求差异内容
• 可扩展的 MCP 协议工具处理器接线机制
• 跨平台支持（Windows、Mac、Linux）

---

安装

使用 npx（推荐）

无需克隆，直接运行：

npx -y bitbucket-server-mcp

本地安装

克隆并构建项目：

git clone https://github.com/your-org/bitbucket-server-mcp.git
cd bitbucket-server-mcp
npm install
npm run build

---

快速开始

1. 将 .env.example 复制为 .env，并配置 Bitbucket Server 凭据。

2. 启动 MCP 服务：

   npm start
   # or
   node build/index.js
   

---

🚀 MCP 服务配置

将以下内容添加到 MCP 配置中（例如 cline_mcp_settings.json）：

{
  "servers": [
    {
      "name": "bitbucket-server-mcp",
      "command": "npx",
      "args": ["-y", "bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server",
        "BITBUCKET_TOKEN": "your-access-token",
        "BITBUCKET_DEFAULT_PROJECT": "your-default-project",
        "BITBUCKET_DEFAULT_REVIEWERS": "user1,user2"
      }
    }
  ]
}

直接使用 Node

如果无法使用 npx，请按以下方式配置：

• Windows：

  "command": "node",
  "args": ["C:\\path\\to\\bitbucket-server-mcp\\build\\index.js"],
  

• Mac/Linux：

  "command": "node",
  "args": ["/path/to/bitbucket-server-mcp/build/index.js"],
  

---

环境变量

变量	描述	必填	示例
BITBUCKET_URL	Bitbucket Server 基础 URL	是	https://bitbucket.example.com
BITBUCKET_TOKEN	个人访问令牌	是	your-access-token
BITBUCKET_DEFAULT_PROJECT	默认项目键	否	PROJKEY
BITBUCKET_DEFAULT_REVIEWERS	以逗号分隔的评审者用户名	否	user1,user2
BITBUCKET_USERNAME	用户名（不使用令牌时）	否	your-username
BITBUCKET_PASSWORD	密码（不使用令牌时）	否	your-password

详情请参阅 .env.example。

---

开发

• 检查代码规范：

  npm run lint
  

• 以监视模式运行：

  npm run dev
  

---

测试

运行测试套件：

npm test

---

贡献

欢迎贡献！请提交问题，或为新功能、错误修复和改进提交拉取请求。

---

许可证

本项目采用 MIT License 许可。

---