mcp-bitbucket

用于 Bitbucket Cloud REST API 2.0 的 MCP（stdio）服务器。可与 Cursor 配合使用：拉取请求、流水线、日志、克隆。

工具与典型的 bb_get / bb_post / bb_put / bb_patch / bb_delete / bb_clone 集合一致。

要求

• Node.js 18+

• Atlassian 作用域 API 令牌（应用密码不起作用）

令牌：id.atlassian.com → API tokens。
有用的范围：读取仓库、拉取请求、流水线和用户（read:repository:bitbucket、read:pullrequest:bitbucket、read:pipeline:bitbucket、read:user:bitbucket）。如需写入，请添加相应的 write:*。

Related MCP server: bitbucket-mcp

安装

git clone https://github.com/genkis/mcp-bitbucket.git
cd mcp-bitbucket
npm install

将 .env.example 复制为 .env 并在本地填写值。不要提交 .env 文件。

Cursor（~/.cursor/mcp.json）

仅将令牌和电子邮件保存在 Cursor 的本地配置中，不要保存在此仓库中。

{
  "mcpServers": {
    "bitbucket": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp-bitbucket/index.js"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-scoped-api-token",
        "BITBUCKET_DEFAULT_WORKSPACE": "your-workspace-slug"
      }
    }
  }
}

更改后，在 Cursor 中重新加载 MCP 服务器。

变量：

别名：BITBUCKET_USERNAME、BITBUCKET_API_TOKEN。

工具

/2.0 前缀会自动添加。路径以 / 开头，例如 /workspaces。

公共参数：path，可选 queryParams、jq（JMESPath）、outputFormat（toon 或 json）。bb_post / bb_put / bb_patch 需要 body。

路径示例：

• /workspaces

• /repositories/{workspace}/{repo}/pullrequests/{id}

• /repositories/{workspace}/{repo}/pullrequests/{id}/diff

• /repositories/{workspace}/{repo}/pipelines/?pagelen=50&sort=-created_on

• /repositories/{workspace}/{repo}/pipelines/{uuid}/steps/{stepUuid}/log

在处理列表时，建议始终使用 jq 过滤器，以免将整个 JSON 拉入模型。

安全

• 不要提交令牌、.env 或包含机密的 mcp.json。

• 此服务器仅使用 Basic Auth（电子邮件 + 令牌）将请求转发到 api.bitbucket.org。

• 日志和错误不会输出令牌。