atlassian-bitbucket-server-mcp

atlassian-bitbucket-server-mcp

0
developer_tools

Atlassian Bitbucket MCP Server is designed to facilitate integration between AI systems and Bitbucket repositories. It provides access to repository information and pull request tools via a type-safe API, leveraging Bitbucket's OpenAPI specs.

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 file for details.