bitbucket-review-mcp

# bitbucket-review-mcp An [MCP](https://modelcontextprotocol.io) server for **interactive Bitbucket Cloud pull-request review** with Claude. Claude reads the PR, its diff and the surrounding source code, analyses design/data-flow, proposes per-module test cases and best practices, and — only when you confirm — posts findings back as inline + summary comments. ## Tools exposed | Tool | Purpose | | --- | --- | | `list_open_prs` | List open pull requests. | | `get_pr` | PR metadata: title, description, branches, commit hashes. | | `get_pr_diff` | The raw unified diff for a PR. | | `get_pr_files` | Changed files with per-file added/removed line counts. | | `get_file_content` | Read a file's full contents at a commit/branch. | | `post_inline_comment` | Post an inline comment on a line in the diff. | | `post_summary_comment` | Post a top-level summary comment on the PR. | ## Installation Install from PyPI: ```bash pip install bitbucket-review-mcp ``` This installs a console command, `bitbucket-review-mcp`, that runs the MCP server over stdio. ### Install from source ```bash git clone https://github.com/fahidnibu/pr_mcp.git cd pr_mcp pip install . ``` ## Configuration The server reads credentials from environment variables (or a `.env` file in the directory it is launched from). Copy `.env.example` to `.env` and fill it in: ```bash # Prefer an access token (Bitbucket → Workspace/Repo settings → Access tokens). # Scopes needed: pullrequest (read) and pullrequest:write (to post comments). BITBUCKET_ACCESS_TOKEN= # Fallback auth if you don't use an access token (app passwords are being # phased out by Atlassian): BITBUCKET_USERNAME= BITBUCKET_APP_PASSWORD= # Optional defaults so you can review by PR id alone: BITBUCKET_WORKSPACE= BITBUCKET_REPO_SLUG= ``` ## Register with Claude Code Add the server to your `.mcp.json` (this repo ships one already): ```json { "mcpServers": { "bitbucket": { "command": "bitbucket-review-mcp" } } } ``` Restart …