bitbucket_mcp

dmtr/bitbucket_mcp

3.2

If you are the rightful owner of bitbucket_mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This project provides an implementation of the Model Context Protocol (MCP) server in Python for interacting with Bitbucket repositories.

Tools
6
Resources
0
Prompts
0

Bitbucket MCP Server

This project provides an implementation of the Model Context Protocol (MCP) server in Python. It allows users to interact with Bitbucket repositories through a standardized interface, supporting code searches, repository management, and more.

Features

  • Implements the MCP server protocol for Bitbucket integration
  • Searches code in Bitbucket repositories with support for multiple pages of results
  • Retrieves repository information and commit history
  • Fetches file contents from repositories
  • Creates branches and pull requests
  • Automatically masks sensitive credentials in search results
  • Returns data in JSON format
  • Includes syntax rules for searching files in Bitbucket

Requirements

  • Python 3.x
  • atlassian-python-api library
  • mcp library with CLI support
  • uv for project management

Environment Variables

The server requires the following environment variables:

  • BITBUCKET_WORKSPACE - Your Bitbucket workspace name
  • APP_USERNAME - Bitbucket username
  • APP_PASSWORD - Bitbucket password or app password

Configuration Example

"BitbucketMCP": {
      "type": "local",
      "command":[ "uv",
        "run",
        "server.py"
      ],
      "environment": {
        "BITBUCKET_WORKSPACE": "test_workspace",
        "APP_USERNAME": "username",
        "APP_PASSWORD": "password"
      }
}

Available Tools

  • bitbucket_code_search - Search code in repositories
  • bitbucket_get_repositories - List and filter repositories
  • bitbucket_create_branch - Create a new branch
  • bitbucket_get_commits - Retrieve commit history
  • bitbucket_get_file_content - Get raw file content
  • bitbucket_create_pr - Create pull requests
  • bitbucket_get_pull_requests - List pull requests for a repository
  • bitbucket_get_pull_request - Retrieve a single pull request by ID
  • bitbucket_get_pull_request_diff - Get the diff for a pull request