mcp-bitbucket

Bitbucket Cloud REST API 2.0용 MCP(stdio) 서버입니다. Cursor와 함께 작동합니다: pull request, pipeline, 로그, clone.

도구는 일반적인 bb_get / bb_post / bb_put / bb_patch / bb_delete / bb_clone 세트와 일치합니다.

요구 사항

• Node.js 18+

• Atlassian Scoped API Token(앱 비밀번호는 작동하지 않음)

토큰: 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-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에 요청을 전달만 합니다.

• 로그와 오류에는 토큰이 출력되지 않습니다.