🚀 Atlassian Bitbucket MCP 服务器

Atlassian Bitbucket MCP 服务器是一款用于与 Bitbucket 代码仓库进行交互的工具。它具备搜索、拉取请求管理和问题跟踪等功能，能有效提升用户在 Bitbucket 平台上的操作效率。

🚀 快速开始

Atlassian Bitbucket MCP 服务器可帮助你在 Bitbucket 代码仓库中便捷地进行搜索、管理拉取请求以及跟踪问题。按照以下安装和配置步骤，即可快速使用该工具。

✨ 主要特性

• 搜索：可在指定的工作区中搜索文件、拉取请求和提交。
• 拉取请求管理：支持创建、查看和评论拉取请求。
• 问题跟踪：能够列出和添加问题评论。

📦 安装指南

先决条件

• Node.js 版本要求为 14.x 或更高版本，推荐使用 LTS 版本。
• 必须安装 npm。

使用密钥认证

1. 在 Bitbucket 中生成 OAuth 消息密钥：
   • 登录 Bitbucket 管理控制台。
   • 转到 OAuth 工具 > 生成消费者。
   • 填写 Consumer Key（例如：mcp-server）。
   • 生成并下载密钥对。
2. 配置 MCP 服务器：

BITBUCKET_OAUTH_KEY=your_consumer_key \
BITBUCKET_OAUTH_SECRET=your_secret_key \
npm install -g @aashari/mcp-server-atlassian-bitbucket

3. 使用密码认证（可选）：

npm install -g @aashari/mcp-server-atlassian-bitbucket

配置方法

基于文件的配置

创建 config.json 文件，内容如下：

{
  "bitbucket": {
    "base-url": "https://api.bitbucket.org",
    "workspace": "your_workspace"
  },
  "auth": {
    "type": "oauth2",
    "consumer-key": "your_consumer_key",
    "secret-key": "your_secret_key"
  }
}

环境变量配置

设置以下环境变量：

• BITBUCKET_BASE_URL：Bitbucket API 地址，默认为 https://api.bitbucket.org。
• BITBUCKET_WORKSPACE：目标工作区。
• BITBUCKET_AUTH_TYPE：认证类型，支持 oauth2 和 password。
  • 对于 oauth2：
    • BITBUCKET_OAUTH_KEY：消费者密钥。
    • BITBUCKET_OAUTH_SECRET：密钥密钥。
  • 对于 password：
    • BITBUCKET_USERNAME：Bitbucket 用户名。
    • BITBUCKET_PASSWORD：Bitbucket 密码。

安装与运行

npm install -g @aashari/mcp-server-atlassian-bitbucket
mcp-atlassian-bitbucket --help

💻 使用示例

基础用法

搜索文件

{
  "workspace": "your_workspace",
  "query": "search_string",
  "scope": "files"
}

搜索拉取请求

{
  "workspace": "your_workspace",
  "repo_slug": "repository_name",
  "query": "pr_keyword",
  "scope": "pullrequests"
}

搜索提交记录

{
  "workspace": "your_workspace",
  "repo_slug": "repository_name",
  // 原文档此处未完整，保持原样
}