mcp-bitbucket

Сервер MCP (stdio) для Bitbucket Cloud REST API 2.0. Работает с Cursor: pull request'ы, pipeline'ы, логи, клонирование.

Инструменты соответствуют типовому набору bb_get / bb_post / bb_put / bb_patch / bb_delete / bb_clone.

Требования

• Node.js 18+

• Scoped API Token Atlassian (App Passwords не работают)

Токен: id.atlassian.com → API tokens.
Полезные области: чтение репозитория, pull request'ов, pipeline'ов и пользователя (read:repository:bitbucket, read:pullrequest:bitbucket, read:pipeline:bitbucket, read:user:bitbucket). Для записи добавьте соответствующие write:*.

Related MCP server: Bitbucket Cloud MCP Server

Установка

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

Скопируйте .env.example в .env и заполните значения локально. Файл .env не коммитьте.

Cursor (~/.cursor/mcp.json)

Храните токен и e-mail только в локальной конфигурации 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"
      }
    }
  }
}

После изменения перезагрузите серверы MCP в Cursor.

Переменные:

Алиасы: 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 с секретами.

• Этот сервер только передаёт запросы на api.bitbucket.org с Basic Auth (e-mail + токен).

• Логи и ошибки не выводят токен.