AI导哈

Bitbucket MCP服务器

一个与Bitbucket API集成的Model Context Protocol (MCP)服务器，用于管理和操作Bitbucket仓库、分支和拉取请求。

  • by hongjunland
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 hongjunland/bitbucket-mcp-server

使用说明

Markdown# Bitbucket MCP 服务器

这是与Rainbucket API联动的Model Context Protocol（MCP）服务器。

要求

  • Node.js 18 或更高版本
  • npm 或 yarn
  • Bitbucket帐户及工作区访问权限

详细设置指南

第一步：生成Bitbucket应用密码

  1. Bitbucket登录到（某处）
  2. 点击右上角的个人资料图标→ 个人设置 （个人设置）
  3. 在左侧菜单中 应用密码 (应用密码) 选择
  4. 生成应用密码 (创建应用密码) 点击
  5. 标签输入（例如：“MCP 服务器”）
  6. 以下权限选择：
    • ✅ **仓库（或存储库）**读，写
    • ✅ **拉取请求（或合并请求）**读，写
  7. 生成 点击后复制密码（⚠️仅显示一次！）

第二步：确认工作区名称

  1. 在Bitbucket仪表板中选择工作区
  2. 在URL中确认工作区名称： https://bitbucket.org/{워크스페이스명}/
  3. 或者在左下角查看工作区名称

第三步：设置环境变量

cp .env.example .env

.env 在文件中输入实际值：

BITBUCKET_USERNAME=your_email@example.com
BITBUCKET_APP_PASSWORD=your_app_password_here
BITBUCKET_WORKSPACE=your_workspace_name

注意事项：

  • BITBUCKET_USERNAME银 电子邮件地址请输入
  • BITBUCKET_APP_PASSWORD生成的 应用密码请输入
  • BITBUCKET_WORKSPACE是工作空间的 准确的名称请输入

安装及运行

# 의존성 설치
npm install

# 빌드
npm run build

# 실행
npm start

# 개발 모드 (파일 변경 시 자동 재시작)
npm run dev

可用的工具

工具名称 说明 必需参数
list_repositories 查看工作区的所有存储库列表 无
get_repository 查看特定存储库的详细信息 repo_slug
list_branches 查看仓库的分支列表 repo_slug
get_commits 查看仓库的提交历史 repo_slug， branch （可选）， limit （可选）
create_branch 创建新分支 repo_slug， branch_name， source_branch （可选）
create_pull_request 生成完整请求 repo_slug， source_branch， title， description （可选）， destination_branch （可选）

MCP客户端连接

Claude Desktop 设置

  1. 打开Claude Desktop的设置文件：

    • macOS（麦金塔操作系统）: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. 添加以下设置：

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/bitbucket-server.js"],
      "env": {
        "BITBUCKET_USERNAME": "your_email@example.com",
        "BITBUCKET_APP_PASSWORD": "your_app_password",
        "BITBUCKET_WORKSPACE": "your_workspace"
      }
    }
  }
}
  1. 重启 Claude Desktop

路径设置提示：

  • macOS/Linux： /Users/username/projects/mcp-server/dist/bitbucket-server.js
  • Windows： C:\\Users\\username\\projects\\mcp-server\\dist\\bitbucket-server.js

使用示例

在 Claude Desktop 中，您可以按以下方式提出请求：

- "내 저장소 목록을 보여줘"
- "project-name 저장소의 브랜치 목록을 보여줘"
- "main 브랜치의 최근 커밋 10개를 보여줘"
- "develop 브랜치에서 feature/new-feature 브랜치를 만들어줘"
- "feature 브랜치에서 main으로 풀 리퀘스트를 만들어줘"

解决问题

认证错误 (401 未授权)

  • ✅ 确认电子邮件地址是否正确
  • ✅ 确认应用密码是否正确输入
  • ✅ 确认已授予应用密码所需的权限

找不到工作区（404 未找到）

  • ✅ 检查工作区名称的大小写
  • ✅ 确认对工作区的访问权限
  • ✅ 从URL中复制准确的工作区名称

MCP服务器连接错误

  • ✅ npm run build 运行以检查最新构建
  • ✅ dist/bitbucket-server.js 检查文件是否存在
  • ✅ 检查 Node.js 版本（18 以上）
  • ✅ 重启Claude Desktop

网络错误

  • ✅ 检查网络连接状态
  • ✅ Bitbucket 状态 查看页面
  • ✅ 检查防火墙设置

项目结构

mcp-server/
├── src/
│   └── bitbucket-server.ts    # 메인 서버 코드
├── dist/                        # 빌드된 파일
│   └── bitbucket-server.js
├── .env.example                 # 환경 변수 템플릿
├── .env                         # 실제 환경 변수 (git 제외)
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

安全注意事项

⚠️ 重要：

  • .env 千万不要把文件提交到Git中
  • 不要与他人共享应用密码
  • 删除不使用的应用密码
  • 定期更新应用密码

许可证

麻省理工学院（MIT）

贡献

随时欢迎提出问题或请求！

相关 MCP