MCP Bitbucket

🚀 MCP Bitbucket Python 🦊

A Python implementation of the MCP server for Bitbucket integration. MCP (Model Context Protocol) enables AI applications to securely access local tools. This server runs locally on the same machine as your AI application.

🚀 Quick Start

📦 Installation

# Install the server locally
git clone https://github.com/kallows/mcp-bitbucket.git

💻 Usage Examples

Environment Configuration

The server requires setting Bitbucket credentials as environment variables:

export BITBUCKET_USERNAME="your-username"
export BITBUCKET_APP_PASSWORD="your-app-password"

✨ Features

This MCP server provides the following Bitbucket integration tools:

• bb_create_repository: Create a new Bitbucket repository

  • Required: name (repository name)
  • Optional: description, workspace (default: kallows), project key, private (default: true), issue tracking (default: true)

• bb_create_branch: Create a new branch in the repository

  • Required: repo_slug, branch (name of the new branch)
  • Optional: workspace (default: kallows), start point (default: main branch)

• bb_delete_repository: Delete a Bitbucket repository

  • Required: repo_slug
  • Optional: workspace (default: kallows)

• bb_read_file: Read a file from the repository

  • Required: repo_slug, path (file path in the repository)
  • Optional: workspace (default: kallows), branch (default: main branch)

• bb_write_file: Create or update a file in the repository

  • Required: repo_slug, path, content
  • Optional: workspace (default: kallows), branch (default: main branch), message (commit message)

• bb_create_issue: Create an issue in the repository

  • Required: repo_slug, title, content
  • Optional: workspace (default: kallows), type (bug/enhancement/proposal/task), priority (trivial/minor/major/critical/blocker)

• bb_delete_issue: Delete an issue in the repository

  • Required: repo_slug, issue ID
  • Optional: workspace (default: kallows)

• bb_search_repositories: Search for Bitbucket repositories using query syntax

  • Required: query (e.g., 'name ~ "test"' or 'project.key = "PROJ"')
  • Optional: workspace (default: kallows), page number (default: 1), page length (default: 10, max: 100)

• bb_delete_file: Delete a file in the repository

  • Required: repo_slug, path
  • Optional: workspace (default: kallows), branch (default: main branch), message (commit message)

• bb_create_pull_request: Create a pull request

  • Required: repo_slug, title, source branch
  • Optional: workspace (default: kallows), target branch (default: main branch), description, close source branch (default: true)

🔧 Technical Details

Project Structure

mcp-bitbucket/
├── README.md
├── pyproject.toml
├── src/
│   └── bitbucket_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_bb_api.py
    └── test_bb_integration.py