Bitbucketmcp1 0

比特桶MCP服务器

](https://www.npmjs.com/package/@yogeshrathod/bitbucket-mcp) ](https://www.npmjs.com/package/@yogeshrathod/bitbucket-mcp)  ](https://nodejs.org/)  

用于Bitbucket云和服务器API的模型上下文协议（MCP）服务器，使用TypeScript和Node.js构建。为存储库管理、拉取请求、分支、提交和文件操作提供全面的工具。

特性

• 双重API支持 -Bitbucket Cloud API v2和服务器API v1.0（由基本URL自动检测）
• 25+MCP工具 -全面覆盖Bitbucket操作
• 灵活配置 -环境变量或JSON配置文件
• 智能默认值 -自动检测当前分支以创建PR
• 结构化错误 -详细的错误响应和建议
• TypeScript -全型安全和现代ES模块

安装

使用npm（全局）

npm install -g @yogeshrathod/bitbucket-mcp

使用npx（无需安装）

npx @yogeshrathod/bitbucket-mcp

更新中

更新全局安装

npm update -g @yogeshrathod/bitbucket-mcp

使用npx更新到最新版本

npx @yogeshrathod/bitbucket-mcp@latest

检查当前版本

npm list -g @yogeshrathod/bitbucket-mcp

配置

使用环境变量或JSON配置文件配置服务器。

环境变量

export ATLASSIAN_SITE_URL="bitbucket"  # or your server URL
export ATLASSIAN_USER_EMAIL="your-email@example.com"
export ATLASSIAN_API_TOKEN="your-app-password-or-pat"

JSON配置文件

在您的工作目录中创建以下文件之一： mcp.config.json, .mcp.config.json，或 .bitbucket.mcp.json

{
  "bitbucket": {
    "defaultDestinationBranch": "main",
    "environments": {
      "ATLASSIAN_SITE_URL": "https://bitbucket.company.com/rest/api/1.0",
      "ATLASSIAN_USER_EMAIL": "your-email@example.com",
      "ATLASSIAN_API_TOKEN": "your-app-password",
      "BITBUCKET_DEFAULT_DEST_BRANCH": "main"
    }
  }
}

MCP客户端配置

添加到您的MCP客户端配置中（例如，Claude Desktop、Windsurf）：

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["@yogeshrathod/bitbucket-mcp"],
      "env": {
        "ATLASSIAN_SITE_URL": "bitbucket",
        "ATLASSIAN_USER_EMAIL": "your-email@example.com",
        "ATLASSIAN_API_TOKEN": "your-app-password"
      }
    }
  }
}

工具参考

所有特定于存储库的工具都需要 workspace 和 repoSlug 参数。

连接与发现

拉取请求

分支

提交

文件

使用示例

列出打开拉取请求

{
  "tool": "pr_list",
  "arguments": {
    "workspace": "my-workspace",
    "repoSlug": "my-repo",
    "state": "OPEN"
  }
}

创建拉取请求

{
  "tool": "pr_create",
  "arguments": {
    "workspace": "my-workspace",
    "repoSlug": "my-repo",
    "title": "Add new feature",
    "sourceBranch": "feature/my-feature",
    "destBranch": "main",
    "description": "This PR adds a new feature"
  }
}

合并拉取请求

{
  "tool": "pr_merge",
  "arguments": {
    "workspace": "my-workspace",
    "repoSlug": "my-repo",
    "prId": 123,
    "mergeStrategy": "squash",
    "closeSourceBranch": true
  }
}

比较分支机构

{
  "tool": "branch_compare",
  "arguments": {
    "workspace": "my-workspace",
    "repoSlug": "my-repo",
    "source": "feature/my-feature",
    "destination": "main"
  }
}

发展

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Start development server
npm start

需求

• Node.js>=18.17.0
• Bitbucket云应用密码或服务器个人访问令牌

许可证

麻省 理工© Yogesh Rathod 的