Metadata-Version: 2.4
Name: msrashed-bitbucket-mcp-server
Version: 0.1.0
Summary: Comprehensive Bitbucket Cloud MCP server for repositories, PRs, pipelines, branches, and more
Project-URL: Homepage, https://github.com/msalah-eg/bitbucket-mcp-server
Project-URL: Repository, https://github.com/msalah-eg/bitbucket-mcp-server
Project-URL: Issues, https://github.com/msalah-eg/bitbucket-mcp-server/issues
Author-email: Mohamed Salah <mohamed@buyinggroup.com>
License: MIT
Keywords: bitbucket,cicd,git,mcp,model-context-protocol,pipelines,pull-requests
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.12
Requires-Dist: click>=8.1.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.24.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Description-Content-Type: text/markdown

# Bitbucket Cloud MCP Server

A comprehensive MCP (Model Context Protocol) server for the Bitbucket Cloud REST API v2.0.

## Features

- **34 tools** covering repositories, pull requests, branches, pipelines, commits, and webhooks
- Full pull request lifecycle: create, review, comment, approve, merge, decline
- CI/CD pipeline management: trigger, stop, view logs
- Code search across workspace repositories
- Branch comparison and management
- Tag and release management

## Installation

```bash
uv pip install msrashed-bitbucket-mcp-server
```

## Configuration

Set environment variables:

```bash
export BITBUCKET_USERNAME="your-username"
export BITBUCKET_APP_PASSWORD="your-app-password"
export BITBUCKET_WORKSPACE="your-workspace"
```

Generate an app password at: Bitbucket > Settings > Personal settings > App passwords

## Usage

### As MCP Server (stdio)

```bash
bitbucket-mcp-server run
```

### With Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "bitbucket": {
      "command": "bitbucket-mcp-server",
      "args": ["run"],
      "env": {
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_APP_PASSWORD": "your-app-password",
        "BITBUCKET_WORKSPACE": "your-workspace"
      }
    }
  }
}
```

### Verify Connection

```bash
bitbucket-mcp-server check
```

### List Available Tools

```bash
bitbucket-mcp-server info
```

## License

MIT
