bitbucket-mcp-server

pdogra1299/bitbucket-mcp-server

3.4

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

The Bitbucket MCP Server is a Model Context Protocol server designed to facilitate interactions with the Bitbucket API, supporting both Bitbucket Cloud and Bitbucket Server.

The Bitbucket MCP Server provides a comprehensive suite of tools for managing and interacting with Bitbucket repositories. It supports a wide range of functionalities, including pull request lifecycle management, branch management, file and directory operations, and code review processes. The server is designed to streamline workflows by offering automated and programmatic access to Bitbucket's features, making it easier for developers to manage their code repositories. With support for both Bitbucket Cloud and Bitbucket Server, the MCP server ensures compatibility across different deployment environments. Authentication is handled via Bitbucket App Passwords, ensuring secure access to repository data. The server can be easily integrated into existing workflows using npx or by running from source, providing flexibility in deployment. Additionally, the server includes smart features like code snippet-based commenting and file content truncation to handle large files efficiently.

Features

  • Comprehensive pull request lifecycle management, including creation, updating, and merging.
  • Branch management tools for listing, deleting, and retrieving branch details.
  • File and directory operations with smart truncation for large files.
  • Code review tools with support for inline comments and code suggestions.
  • Flexible authentication setup using Bitbucket App Passwords.

Usages

npx with Bitbucket Cloud

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "@nexus2520/bitbucket-mcp-server"
      ],
      "env": {
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

npx with Bitbucket Server

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "@nexus2520/bitbucket-mcp-server"
      ],
      "env": {
        "BITBUCKET_USERNAME": "your.email@company.com",
        "BITBUCKET_TOKEN": "your-http-access-token",
        "BITBUCKET_BASE_URL": "https://bitbucket.yourcompany.com"
      }
    }
  }
}

node with Bitbucket Cloud

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/absolute/path/to/bitbucket-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

node with Bitbucket Server

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/absolute/path/to/bitbucket-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_USERNAME": "your.email@company.com",
        "BITBUCKET_TOKEN": "your-http-access-token",
        "BITBUCKET_BASE_URL": "https://bitbucket.yourcompany.com"
      }
    }
  }
}

Tools

  1. get_pull_request

    Retrieve detailed information about a pull request.

  2. list_pull_requests

    List pull requests with filters such as state and author.

  3. create_pull_request

    Create new pull requests.

  4. update_pull_request

    Update pull request details like title and description.

  5. add_comment

    Add comments to pull requests, supporting inline and general comments.