If you want to learn more about Quarkus, please visit its website: https://quarkus.io/.

Table of Contents

• Quick Start
• MCP Tools Reference
• Configuration
• Running with Docker
• Development
• Building
• API Documentation
• Use Cases
• Troubleshooting
• Roadmap
• Contributing

Quick Start

Prerequisites

1. Bitbucket API Token: Create an API token at https://bitbucket.org/account/settings/api-token/
   • Required permissions: repository:read, pullrequest:read, pullrequest:write
   • See Creating a Bitbucket API Token for detailed instructions
2. Docker (optional): For running the containerized version

Using Docker (Recommended)

docker run -p 8080:8080 \
  -e BITBUCKET_EMAIL=your-email@example.com \
  -e BITBUCKET_API_TOKEN=your-api-token \
  -e BITBUCKET_WORKSPACE=your-workspace \
  subrutin/bitbucket-mcp-server:latest

Using MCP with Supported Clients

This server supports multiple transport protocols. Choose the method that works best for your client:

🎯 Method 1: stdio Transport (Recommended - Works with All Clients)

The stdio transport allows direct process communication without needing a running HTTP server. This is the universal method that works with all MCP clients.

For Claude Desktop, add this to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BITBUCKET_EMAIL=your-email@example.com",
        "-e", "BITBUCKET_API_TOKEN=your-api-token",
        "-e", "BITBUCKET_WORKSPACE=your-workspace",
        "subrutin/bitbucket-mcp-server:stdio-0.0.2"
      ]
    }
  }
}

Restart Claude Desktop, and you'll see the Bitbucket tools available in the 🔨 tools menu.

For Cursor IDE, add to your Cursor settings (same format as Claude Desktop):

{
  "mcpServers": {
    "bitbucket": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "BITBUCKET_EMAIL=your-email@example.com",
        "-e", "BITBUCKET_API_TOKEN=your-api-token",
        "-e", "BITBUCKET_WORKSPACE=your-workspace",
        "subrutin/bitbucket-mcp-server:stdio-0.0.2"
      ]
    }
  }
}

For VS Code with MCP extension (same format):

{
  "mcp.servers": {
    "bi

... [View full README on GitHub](https://github.com/tedysaputro/personal-bitbucket-mcp-server#readme)