MCP Bitbucket Python

by Kallows

Integrations

  • Provides tools for repository management (creating, deleting, searching), branch operations, file handling (read, write, delete), issue tracking (creating, deleting issues), and pull request creation in Bitbucket repositories.

MCP Bitbucket Python 🦊

A Python implementation of an MCP server for Bitbucket integration. MCP (Model Context Protocol) enables secure, local tool access for AI applications. The server runs locally on the same machine as your AI application.

Installation

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

Tools Available

This MCP server provides the following Bitbucket integration tools:

  • bb_create_repository: Create a new Bitbucket repository
    • Required: name (repository name)
    • Optional: description, workspace (defaults to kallows), project_key, is_private (default: true), has_issues (default: true)
  • bb_create_branch: Create a new branch in a repository
    • Required: repo_slug, branch (name for the new branch)
    • Optional: workspace (defaults to kallows), start_point (defaults to main)
  • bb_delete_repository: Delete a Bitbucket repository
    • Required: repo_slug
    • Optional: workspace (defaults to kallows)
  • bb_read_file: Read a file from a repository
    • Required: repo_slug, path (file path in repository)
    • Optional: workspace (defaults to kallows), branch (defaults to main/master)
  • bb_write_file: Create or update a file in a repository
    • Required: repo_slug, path, content
    • Optional: workspace (defaults to kallows), branch (defaults to main), message (commit message)
  • bb_create_issue: Create an issue in a repository
    • Required: repo_slug, title, content
    • Optional: workspace (defaults to kallows), kind (bug/enhancement/proposal/task), priority (trivial/minor/major/critical/blocker)
  • bb_delete_issue: Delete an issue from a repository
    • Required: repo_slug, issue_id
    • Optional: workspace (defaults to kallows)
  • bb_search_repositories: Search Bitbucket repositories using query syntax
    • Required: query (e.g., 'name ~ "test"' or 'project.key = "PROJ"')
    • Optional: workspace (defaults to kallows), page (default: 1), pagelen (default: 10, max: 100)
  • bb_delete_file: Delete a file from a repository
    • Required: repo_slug, path
    • Optional: workspace (defaults to kallows), branch (defaults to main), message (commit message)
  • bb_create_pull_request: Create a pull request
    • Required: repo_slug, title, source_branch
    • Optional: workspace (defaults to kallows), destination_branch (defaults to main), description, close_source_branch (default: true)

Environment Setup

The server requires Bitbucket credentials to be set up as environment variables:

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

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
-
security - not tested
F
license - not found
-
quality - not tested

A Python implementation of an MCP server that enables secure, local Bitbucket integration for AI applications, providing tools for repository management, branch creation, file operations, issue tracking, and pull request creation.

  1. Installation
    1. Tools Available
      1. Environment Setup
        1. Project Structure

          Related MCP Servers

          • A
            security
            F
            license
            A
            quality
            MCP Server for the GitHub API, providing features for file operations, repository management, and advanced search, with automatic branch creation and comprehensive error handling.
            Last updated -
            18
            4
            1
            TypeScript
          • -
            security
            F
            license
            -
            quality
            This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
            Last updated -
            Python
          • A
            security
            A
            license
            A
            quality
            A server that provides a persistent Python REPL environment through the MCP protocol, allowing execution of Python code, variable management, and package installation.
            Last updated -
            3
            3
            Python
            MIT License
          • -
            security
            A
            license
            -
            quality
            An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
            Last updated -
            132
            Python
            MIT License
            • Apple
            • Linux

          View all related MCP servers

          ID: xla8cbmni3