mcpField
A
Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP Server

Local
github.com/guenichoneVersion Control0Updated 59w ago
Repository

About Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP Server connects self-hosted Bitbucket Server/Data Center to AI systems for teams working with repositories through AI. It provides type-safe API integration based on official OpenAPI specifications.

Key features

  1. 01Access projects, repositories, and branches
  2. 02Read repository files
  3. 03Offer pull request tools
  4. 04Integrate against official OpenAPI specifications
  5. 05Support STDIO and HTTP/SSE transports

Use cases

  1. 01Let AI systems inspect Bitbucket repositories
  2. 02Review project branches and files
  3. 03Work with pull requests through tools

MCP support

This MCP server exposes tools for AI systems to access Bitbucket projects, repositories, branches, files, and pull requests.

#mcp#bitbucket#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "atlassian-bitbucket-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Atlassian Bitbucket MCP Server

A Model Context Protocol (MCP) server that integrates Atlassian Bitbucket Server/Data Center with AI systems.

What It Does

This server enables AI systems to interact with Bitbucket repositories by providing:

  • Access to projects, repositories, branches, and files
  • Tools for working with pull requests
  • Type-safe API integration with official Bitbucket OpenAPI specs

Quick Setup

Prerequisites
  • Node.js (v20+ recommended)
  • npm
  • Python 3 (for OpenAPI filtering script)
  • Bitbucket Server access token
Installation
git clone [<atlassian-bitbucket-server-mcp>](https://github.com/guenichone/atlassian-bitbucket-server-mcp)
cd mcp-server-selfhosted-bitbucket
npm install
npm run build-app
Running the Server
# As STDIO server (default for AI integration)
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

# As HTTP/SSE server
MCP_TRANSPORT=sse \
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

Docker Usage

Using Docker CLI
# Build
docker build -t bitbucket-mcp-server .

# Run
docker run --rm -i \
  -e ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
  -e ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
  bitbucket-mcp-server
Using the Makefile (Recommended)

The project includes a Makefile for simplified Docker operations:

# Build the Docker image
make docker-build

# Run with your Bitbucket credentials
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-run

# Build and run in one command
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-all

# View all available make commands and examples
make help

Environment Variables

  • ATLASSIAN_BITBUCKET_SERVER_URL - Bitbucket server URL
  • ATLASSIAN_BITBUCKET_ACCESS_TOKEN - Your access token
  • MCP_TRANSPORT - stdio (default) or sse
  • PORT - HTTP port when using SSE (default: 3000)

Thanks

This project was inspired by aashari/mcp-server-atlassian-bitbucket.

License

MIT - See LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.