Awesome MCP › Software Development

aashari/mcp-server-atlassian-bitbucket

⭐ 162 TypeScript repository created 2025-03-24

mcp-server-atlassian-bitbucket connects MCP clients to Bitbucket Cloud so an assistant can inspect repositories, pull requests, commits and workspaces and act on them. Rather than wrapping each endpoint in a dedicated tool, it exposes six generic tools that map onto HTTP verbs: bb_get, bb_post, bb_put, bb_patch and bb_delete accept any Bitbucket API path, plus bb_clone which clones a repository to a local target path. Every API tool takes a path starting with a slash, with the /2.0 prefix added automatically, optional queryParams for pagination and filters, an optional jq parameter holding a JMESPath expression that filters or reshapes the response before it reaches the model, and an outputFormat that defaults to a compact toon encoding the project reports as using 30 to 60 percent fewer tokens than JSON. Write verbs additionally take a JSON body. This design means the whole Bitbucket Cloud REST API surface is reachable without the server needing an update for every new endpoint. Authentication supports two paths: scoped Atlassian API tokens used with the account email, which the project recommends because Bitbucket app passwords are being retired in June 2026, and the legacy username plus app password pair. Credentials come from environment variables or a shared ~/.mcp/configs.json file that can also set a default workspace. The package runs through npx or a global npm install and speaks STDIO transport, with documented setup for Claude Desktop, Cursor, Continue.dev and Cline. It requires Node.js 18 or later and works only with Bitbucket Cloud, not Bitbucket Server or Data Center. The same commands are usable directly from a shell as a CLI, which is convenient for verifying credentials before wiring the server into a client.

https://github.com/aashari/mcp-server-atlassian-bitbucket

mcpmcp-serverbitbucketatlassiangitpull-requeststypescriptdevops