MCP Bitbucket Dc

christopherekfeldt14starsClaim this server

MCP server for Bitbucket Data Center — code search, file browsing, PRs, commits, and more

1# MCP Bitbucket Dc

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-11-05

Stars: 14
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install MCP Bitbucket Dc?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MCP Bitbucket Dc need an API key?

No required environment variable is listed on this record.

What transport does MCP Bitbucket Dc use?

MCP Bitbucket Dc runs locally over stdio.

When was MCP Bitbucket Dc last checked?

Last checked 2026-11-05. MCP server for Bitbucket Data Center — code search, file browsing, PRs, commits, and more

From the publisher

Documentation

mcp-bitbucket-dc

MCP (Model Context Protocol) server for Bitbucket Data Center. Enables AI assistants to search code, browse files, manage pull requests, and explore repositories through a standardized interface.

Built with FastMCP in Python. Installs via uvx.

Acknowledgements

Many tools in this project were inspired by atlassian-dc-mcp.
Code search functionality was inspired by @beapirate and prior related implementation work.

Quick Start

1. Generate a Personal Access Token

Log in to your Bitbucket Data Center instance
Go to Manage Account → HTTP access tokens
Click Create token
Set permissions: Repository Read (and Write if you need PR creation/commenting)
Copy the token

2. Configure Your IDE

Add to your MCP configuration (mcp.json in VS Code, claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "bitbucket-dc": {
      "command": "uvx",
      "args": ["mcp-bitbucket-dc"],
      "env": {
        "BITBUCKET_HOST": "git.yourcompany.com",
        "BITBUCKET_API_TOKEN": "your-personal-access-token"
      }
    }
  }
}

That's it. The server starts automatically when your IDE connects.

3. Start Using

Ask your AI assistant:

"Search for CompanyInfoUpdater in the codebase"
"Show me the file structure of the api-service repo in PROJECT"
"Get the content of src/main/Application.java from repo backend"
"List open pull requests in PROJECT/my-repo"
"What branches exist in PROJECT/my-repo?"

Tools Reference

Most read/query tools support response_format:

markdown (default): human-readable output
json: raw structured API response

Code Search

Tool	Description
`bitbucket_code_search`	Search code across all repos with Lucene syntax (`ext:java`, `lang:python`, `repo:name`, `project:KEY`, `AND`/`OR`/`NOT`)

File Browsing

Tool	Description
`bitbucket_browse`	Browse directory tree (files & folders at a path)
`bitbucket_get_file_content`	Get raw file content with syntax highlighting
`bitbucket_list_files`	Recursively list all file paths in a repo
`bitbucket_get_branches`	List branches (filterable)
`bitbucket_get_tags`	List tags (filterable)
`bitbucket_create_branch`	Create a new branch from a branch, tag, or commit

Projects & Repositories

Tool	Description
`bitbucket_get_projects`	List projects (filterable by name/permission)
`bitbucket_get_project`	Get project details
`bitbucket_search_repositories`	Search repos across all projects (no project key required)
`bitbucket_get_repositories`	List repos in a project
`bitbucket_get_repository`	Get repo details with clone URLs

Pull Requests

Tool	Description
`bitbucket_get_pull_requests`	List PRs (filter by state, direction, text)
`bitbucket_get_pull_request`	Get PR details with reviewers
`bitbucket_get_pull_request_comments`	Get PR comments and activity
`bitbucket_get_pull_request_changes`	Get files changed in a PR
`bitbucket_get_pull_request_diff`	Get diff for a file in a PR
`bitbucket_post_pull_request_comment`	Post a comment (general or inline)
`bitbucket_update_pull_request_comment`	Update an existing PR comment
`bitbucket_delete_pull_request_comment`	Delete a PR comment
`bitbucket_create_pull_request`	Create a new PR
`bitbucket_update_pull_request`	Update PR title/description/reviewers
`bitbucket_get_required_reviewers`	Get required reviewers for a branch pair

Commits

Tool	Description
`bitbucket_get_commits`	List commits (filter by path, ref range)
`bitbucket_get_commit`	Get full details of a single commit
`bitbucket_get_commit_diff`	Get the diff for a specific commit

Search Query Syntax

The bitbucket_code_search tool uses Lucene-style queries:

# Simple text search
CompanyInfoUpdater

# Filter by file extension
function ext:java

# Filter by language
config lang:python

# Filter by repository or project
DatabaseHelper repo:backend-api
service project:PLATFORM

# Filter by path
controller path:src/main

# Boolean operators (must be UPPERCASE)
config AND (yaml OR yml)
test NOT unit
UserService AND ext:java AND project:CORE

Configuration

Environment Variable	Required	Description
`BITBUCKET_HOST`	Yes*	Bitbucket DC hostname (e.g. `git.company.com`)
`BITBUCKET_URL`	Yes*	Full base URL alternative (e.g. `https://git.company.com`)
`BITBUCKET_API_TOKEN`	Yes	Personal Access Token
`BITBUCKET_VERIFY_SSL`	No	Verify TLS certificates (default `true`). Set to `false` for self-signed or internal CA deployments.

* Provide either BITBUCKET_HOST or BITBUCKET_URL, not both.

Disabling SSL verification

For Bitbucket DC instances behind a self-signed certificate or an internal CA that isn't trusted by the system store, set BITBUCKET_VERIFY_SSL=false:

{
  "mcpServers": {
    "bitbucket-dc": {
      "command": "uvx",
      "args": ["mcp-bitbucket-dc"],
      "env": {
        "BITBUCKET_HOST": "git.yourcompany.com",
        "BITBUCKET_API_TOKEN": "your-personal-access-token",
        "BITBUCKET_VERIFY_SSL": "false"
      }
    }
  }
}

⚠️ Disabling SSL verification means traffic is not protected against man-in-the-middle attacks. Only use this against trusted internal networks.

Support Matrix

Component	Version(s)	Verification
Bitbucket Data Center	8.19.5	Live smoke tests run locally against a real server
Python runtime	3.10, 3.11, 3.12, 3.13	GitHub Actions CI (`test` workflow matrix)

If you run on a different Bitbucket DC version, please open an issue with results.

Alternative Transports

# SSE transport (for remote/multi-user setups)
uvx mcp-bitbucket-dc --transport sse --host 0.0.0.0 --port 8000

# Streamable HTTP
uvx mcp-bitbucket-dc --transport streamable-http --host 0.0.0.0 --port 8000

By default, HTTP-based transports bind to 127.0.0.1 for safer local development.

Development

# Clone and install
git clone https://github.com/christopherekfeldt/mcp-bitbucket-dc.git
cd mcp-bitbucket-dc
uv sync

# Install git hooks
uv run pre-commit install

# Run locally
export BITBUCKET_HOST=git.yourcompany.com
export BITBUCKET_API_TOKEN=your-token
uv run mcp-bitbucket-dc

# Run tests
uv run pytest

# Run live smoke tests against a real/staging Bitbucket DC
# (requires BITBUCKET_HOST or BITBUCKET_URL + BITBUCKET_API_TOKEN)
RUN_LIVE_SMOKE=1 uv run pytest -m integration -q

Contributor/agent workflow guidance: see AGENTS.md.

Versioning & Stability

This project follows Semantic Versioning. From v1.0.0 onward, tool names, required parameters, and output contracts are stable — breaking changes only in major version bumps.

Upgrade: uvx mcp-bitbucket-dc always uses the latest. Pin with uvx mcp-bitbucket-dc==X.Y.Z.

Release notes: See GitHub Releases for changelogs.

License

MIT — see LICENSE.

MCP Bitbucket Dc

christopherekfeldt14starsClaim this server

MCP server for Bitbucket Data Center — code search, file browsing, PRs, commits, and more

Developer Tools

Install Run on PlugMCPClaim this server

GitHub

Run on PlugMCP

1# MCP Bitbucket Dc

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-11-05

Stars: 14
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install MCP Bitbucket Dc?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MCP Bitbucket Dc need an API key?

No required environment variable is listed on this record.

What transport does MCP Bitbucket Dc use?

MCP Bitbucket Dc runs locally over stdio.

When was MCP Bitbucket Dc last checked?

Last checked 2026-11-05. MCP server for Bitbucket Data Center — code search, file browsing, PRs, commits, and more

From the publisher

Documentation

mcp-bitbucket-dc

MCP (Model Context Protocol) server for Bitbucket Data Center. Enables AI assistants to search code, browse files, manage pull requests, and explore repositories through a standardized interface.

Built with FastMCP in Python. Installs via uvx.

Acknowledgements

Many tools in this project were inspired by atlassian-dc-mcp.
Code search functionality was inspired by @beapirate and prior related implementation work.

Quick Start

1. Generate a Personal Access Token

Log in to your Bitbucket Data Center instance
Go to Manage Account → HTTP access tokens
Click Create token
Set permissions: Repository Read (and Write if you need PR creation/commenting)
Copy the token

2. Configure Your IDE

Add to your MCP configuration (mcp.json in VS Code, claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "bitbucket-dc": {
      "command": "uvx",
      "args": ["mcp-bitbucket-dc"],
      "env": {
        "BITBUCKET_HOST": "git.yourcompany.com",
        "BITBUCKET_API_TOKEN": "your-personal-access-token"
      }
    }
  }
}

That's it. The server starts automatically when your IDE connects.

3. Start Using

Ask your AI assistant:

"Search for CompanyInfoUpdater in the codebase"
"Show me the file structure of the api-service repo in PROJECT"
"Get the content of src/main/Application.java from repo backend"
"List open pull requests in PROJECT/my-repo"
"What branches exist in PROJECT/my-repo?"

Tools Reference

Most read/query tools support response_format:

markdown (default): human-readable output
json: raw structured API response

Code Search

Tool	Description
`bitbucket_code_search`	Search code across all repos with Lucene syntax (`ext:java`, `lang:python`, `repo:name`, `project:KEY`, `AND`/`OR`/`NOT`)

File Browsing

Tool	Description
`bitbucket_browse`	Browse directory tree (files & folders at a path)
`bitbucket_get_file_content`	Get raw file content with syntax highlighting
`bitbucket_list_files`	Recursively list all file paths in a repo
`bitbucket_get_branches`	List branches (filterable)
`bitbucket_get_tags`	List tags (filterable)
`bitbucket_create_branch`	Create a new branch from a branch, tag, or commit

Projects & Repositories

Tool	Description
`bitbucket_get_projects`	List projects (filterable by name/permission)
`bitbucket_get_project`	Get project details
`bitbucket_search_repositories`	Search repos across all projects (no project key required)
`bitbucket_get_repositories`	List repos in a project
`bitbucket_get_repository`	Get repo details with clone URLs

Pull Requests

Tool	Description
`bitbucket_get_pull_requests`	List PRs (filter by state, direction, text)
`bitbucket_get_pull_request`	Get PR details with reviewers
`bitbucket_get_pull_request_comments`	Get PR comments and activity
`bitbucket_get_pull_request_changes`	Get files changed in a PR
`bitbucket_get_pull_request_diff`	Get diff for a file in a PR
`bitbucket_post_pull_request_comment`	Post a comment (general or inline)
`bitbucket_update_pull_request_comment`	Update an existing PR comment
`bitbucket_delete_pull_request_comment`	Delete a PR comment
`bitbucket_create_pull_request`	Create a new PR
`bitbucket_update_pull_request`	Update PR title/description/reviewers
`bitbucket_get_required_reviewers`	Get required reviewers for a branch pair

Commits

Tool	Description
`bitbucket_get_commits`	List commits (filter by path, ref range)
`bitbucket_get_commit`	Get full details of a single commit
`bitbucket_get_commit_diff`	Get the diff for a specific commit

Search Query Syntax

The bitbucket_code_search tool uses Lucene-style queries:

# Simple text search
CompanyInfoUpdater

# Filter by file extension
function ext:java

# Filter by language
config lang:python

# Filter by repository or project
DatabaseHelper repo:backend-api
service project:PLATFORM

# Filter by path
controller path:src/main

# Boolean operators (must be UPPERCASE)
config AND (yaml OR yml)
test NOT unit
UserService AND ext:java AND project:CORE

Configuration

Environment Variable	Required	Description
`BITBUCKET_HOST`	Yes*	Bitbucket DC hostname (e.g. `git.company.com`)
`BITBUCKET_URL`	Yes*	Full base URL alternative (e.g. `https://git.company.com`)
`BITBUCKET_API_TOKEN`	Yes	Personal Access Token
`BITBUCKET_VERIFY_SSL`	No	Verify TLS certificates (default `true`). Set to `false` for self-signed or internal CA deployments.

* Provide either BITBUCKET_HOST or BITBUCKET_URL, not both.

Disabling SSL verification

For Bitbucket DC instances behind a self-signed certificate or an internal CA that isn't trusted by the system store, set BITBUCKET_VERIFY_SSL=false:

{
  "mcpServers": {
    "bitbucket-dc": {
      "command": "uvx",
      "args": ["mcp-bitbucket-dc"],
      "env": {
        "BITBUCKET_HOST": "git.yourcompany.com",
        "BITBUCKET_API_TOKEN": "your-personal-access-token",
        "BITBUCKET_VERIFY_SSL": "false"
      }
    }
  }
}

⚠️ Disabling SSL verification means traffic is not protected against man-in-the-middle attacks. Only use this against trusted internal networks.

Support Matrix

Component	Version(s)	Verification
Bitbucket Data Center	8.19.5	Live smoke tests run locally against a real server
Python runtime	3.10, 3.11, 3.12, 3.13	GitHub Actions CI (`test` workflow matrix)

If you run on a different Bitbucket DC version, please open an issue with results.

Alternative Transports

# SSE transport (for remote/multi-user setups)
uvx mcp-bitbucket-dc --transport sse --host 0.0.0.0 --port 8000

# Streamable HTTP
uvx mcp-bitbucket-dc --transport streamable-http --host 0.0.0.0 --port 8000

By default, HTTP-based transports bind to 127.0.0.1 for safer local development.

Development

# Clone and install
git clone https://github.com/christopherekfeldt/mcp-bitbucket-dc.git
cd mcp-bitbucket-dc
uv sync

# Install git hooks
uv run pre-commit install

# Run locally
export BITBUCKET_HOST=git.yourcompany.com
export BITBUCKET_API_TOKEN=your-token
uv run mcp-bitbucket-dc

# Run tests
uv run pytest

# Run live smoke tests against a real/staging Bitbucket DC
# (requires BITBUCKET_HOST or BITBUCKET_URL + BITBUCKET_API_TOKEN)
RUN_LIVE_SMOKE=1 uv run pytest -m integration -q

Contributor/agent workflow guidance: see AGENTS.md.

Versioning & Stability

This project follows Semantic Versioning. From v1.0.0 onward, tool names, required parameters, and output contracts are stable — breaking changes only in major version bumps.

Upgrade: uvx mcp-bitbucket-dc always uses the latest. Pin with uvx mcp-bitbucket-dc==X.Y.Z.

Release notes: See GitHub Releases for changelogs.

License

MIT — see LICENSE.