Bitbucket MCP Server

Bitbucket MCP 服务

一个模型上下文协议（MCP）服务，可集成 Bitbucket API，用于管理仓库、拉取请求和问题。

功能

• 列出仓库并获取仓库详情
• 管理拉取请求（列出、获取详情、创建）
• 浏览问题
• 完整支持 TypeScript
• 错误处理和验证

设置

1. 安装依赖项：

npm install

2. 设置身份验证：

cp .env.example .env
# Edit .env with your Bitbucket credentials

3. 构建项目：

npm run build

4. 运行服务：

npm start

身份验证

创建 Bitbucket 应用密码：

1. 前往 https://bitbucket.org/account/settings/app-passwords/
2. 创建具有所需权限的新应用密码：
   • 仓库：读取、写入
   • 拉取请求：读取、写入
   • 问题：读取、写入

可用工具

仓库管理

• bitbucket_list_repositories - 列出工作区中的仓库
• bitbucket_get_repository - 获取仓库详情

拉取请求管理

• bitbucket_list_pull_requests - 列出拉取请求
• bitbucket_get_pull_request - 获取拉取请求详情
• bitbucket_create_pull_request - 创建新的拉取请求

问题管理

• bitbucket_list_issues - 列出仓库问题

MCP 配置

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/path/to/bitbucket-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Cursor IDE

将以下内容添加到 Cursor 设置中：

1. 打开 Cursor 设置（Cmd/Ctrl + ,）
2. 搜索“MCP”，或前往 Extensions > MCP
3. 添加新的服务配置：

{
  "name": "bitbucket",
  "command": "node",
  "args": ["/path/to/bitbucket-mcp-server/build/index.js"],
  "env": {
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_APP_PASSWORD": "your-app-password"
  }
}

开发

# Development mode with auto-reload
npm run dev

# Type checking
npm run typecheck

# Linting
npm run lint