Registry / devops / mcp-bitbucket-server

mcp-bitbucket-server

library1.10.8jsnpmunverified

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.

devops http-networking crm-productivity

npm install mcp-bitbucket-server

github ↗package ↗

INSTALL

IMPORT

SIG · MCP-BITBUCKET-SERV

mcp-bitbucket-server

devopsjavascriptv1.10.8

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

runMcpServer

✓ import { runMcpServer } from 'mcp-bitbucket-server';

✗ const runMcpServer = require('mcp-bitbucket-server').runMcpServer;

While primarily run via npx, this symbol could be used for programmatic embedding or testing the server within a TypeScript/JavaScript application.

BitbucketTool

✓ import type { BitbucketTool } from 'mcp-bitbucket-server';

This type represents the interface for a Bitbucket-specific MCP tool. Useful for developers extending or understanding the server's capabilities.

configureServer

✓ import { configureServer } from 'mcp-bitbucket-server';

Hypothetical export for configuring the server programmatically, useful for advanced setups or testing environments where direct command execution is not preferred.

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.

claude mcp add -s user \ bitbucket-server \ npx mcp-bitbucket-server@latest \ -e "BITBUCKET_URL=https://bitbucket.yourcompany.com" \ -e "BITBUCKET_TOKEN=your_personal_access_token"

mcp-bitbucket-server --version

Debug

Known issues

gotchaEnsure your Node.js environment meets the minimum version requirement (>=22.0.0). Running with older versions may lead to runtime errors or unexpected behavior.

fix

Upgrade your Node.js installation to version 22.0.0 or higher.

affects: <1.0.0 (Node <22.0.0)

gotchaPersonal 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'.

fix

Verify and adjust the permissions of your Bitbucket Personal Access Token in your Bitbucket Server profile settings.

affects: >=1.0.0

gotchaAlways 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.

fix

Utilize environment variables (e.g., `BITBUCKET_TOKEN`) or a secrets management system provided by your MCP client or operating environment.

affects: >=1.0.0

Errors

Common errors & fixes

"Authentication failed"

The provided Personal Access Token is incorrect, expired, or revoked.

fix

Generate a new Personal Access Token in Bitbucket Server and ensure it is correctly configured as `BITBUCKET_TOKEN`.

"Access forbidden"

The Personal Access Token has insufficient permissions for the requested operation or the associated user lacks necessary Bitbucket roles.

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').

Upgrade

Version history

1.10.8latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

36 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/evrimalacan/mcp-bitbucket-server ↗

packagehttps://www.npmjs.com/package/mcp-bitbucket-server ↗