{"id":15354,"library":"mcp-bitbucket-server","title":"Bitbucket Server Model Context Protocol Server","description":"mcp-bitbucket-server is a Model Context Protocol (MCP) server designed to connect AI assistants, such as Claude, to Bitbucket Server/Data Center instances. It enables natural language interaction for tasks like reviewing pull requests, managing repositories, searching users, and adding comments directly from an AI interface. The current stable version is 1.10.8. While no explicit release cadence is stated, the use of `npx mcp-bitbucket-server@latest` suggests frequent updates and maintenance. Key differentiators include its focus on the MCP standard, providing 11 specialized tools for Bitbucket operations, optimizing responses to reduce AI token usage, and utilizing Bitbucket Personal Access Tokens for secure authentication rather than OAuth or more complex schemes. It supports Node.js versions 22.0.0 and newer.","status":"active","version":"1.10.8","language":"javascript","source_language":"en","source_url":"https://github.com/evrimalacan/mcp-bitbucket-server","tags":["javascript","mcp","bitbucket","bitbucket-server","model-context-protocol","typescript"],"install":[{"cmd":"npm install mcp-bitbucket-server","lang":"bash","label":"npm"},{"cmd":"yarn add mcp-bitbucket-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add mcp-bitbucket-server","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"While primarily run via npx, this symbol could be used for programmatic embedding or testing the server within a TypeScript/JavaScript application.","wrong":"const runMcpServer = require('mcp-bitbucket-server').runMcpServer;","symbol":"runMcpServer","correct":"import { runMcpServer } from 'mcp-bitbucket-server';"},{"note":"This type represents the interface for a Bitbucket-specific MCP tool. Useful for developers extending or understanding the server's capabilities.","symbol":"BitbucketTool","correct":"import type { BitbucketTool } from 'mcp-bitbucket-server';"},{"note":"Hypothetical export for configuring the server programmatically, useful for advanced setups or testing environments where direct command execution is not preferred.","symbol":"configureServer","correct":"import { configureServer } from 'mcp-bitbucket-server';"}],"quickstart":{"code":"claude mcp add -s user \\\n    bitbucket-server \\\n    npx mcp-bitbucket-server@latest \\\n    -e \"BITBUCKET_URL=https://bitbucket.yourcompany.com\" \\\n    -e \"BITBUCKET_TOKEN=your_personal_access_token\"","lang":"bash","description":"This command registers the Bitbucket Server MCP with the Claude Code CLI, setting up environment variables for the Bitbucket URL and a Personal Access Token."},"warnings":[{"fix":"Upgrade your Node.js installation to version 22.0.0 or higher.","message":"Ensure your Node.js environment meets the minimum version requirement (>=22.0.0). Running with older versions may lead to runtime errors or unexpected behavior.","severity":"gotcha","affected_versions":"<1.0.0 (Node <22.0.0)"},{"fix":"Verify and adjust the permissions of your Bitbucket Personal Access Token in your Bitbucket Server profile settings.","message":"Personal Access Tokens (PATs) must be created with sufficient permissions for the intended operations. For example, commenting on PRs requires 'Write' project/repository permissions, while listing PRs only requires 'Read'.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Utilize environment variables (e.g., `BITBUCKET_TOKEN`) or a secrets management system provided by your MCP client or operating environment.","message":"Always use environment variables or a secure configuration mechanism to store your Bitbucket Personal Access Token, as exposing it directly in scripts or version control is a security risk.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-21T00:00:00.000Z","next_check":"2026-07-20T00:00:00.000Z","problems":[{"fix":"Generate a new Personal Access Token in Bitbucket Server and ensure it is correctly configured as `BITBUCKET_TOKEN`.","cause":"The provided Personal Access Token is incorrect, expired, or revoked.","error":"\"Authentication failed\""},{"fix":"Check the project and repository permissions associated with your Personal Access Token and ensure they match the required scope (e.g., 'Read' or 'Write').","cause":"The Personal Access Token has insufficient permissions for the requested operation or the associated user lacks necessary Bitbucket roles.","error":"\"Access forbidden\""}],"ecosystem":"npm"}