Atlassian Bitbucket MCP 服务器

项目简介

Atlassian Bitbucket MCP 服务器是一个用于与 Bitbucket 代码仓库交互的工具，支持以下功能：

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

安装指南

先决条件

1. Node.js 版本要求：Node.js 14.x 或更高版本，推荐使用 LTS 版本。
2. 必须安装 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",