# Bitbucket MCP Server
Bitbucket Cloud MCP Server for repository, PR, and pipeline tools via FastMCP.
## Quickstart
- Install (dev):
- `python -m pip install -e .[dev]`
- Run (stdio):
- `python -m bitbucket_mcp_server.server_fastmcp`
- Test:
- `pytest -v`
- Makefile targets:
- `make dev` -- runs stdio server
- `make test` -- pytest with coverage
- `make format` / `make lint`
- `make serve-http` -- expose stdio server over HTTP via gateway translate
- `make test-http` -- quick HTTP checks
## MCP Client Snippet
Use this snippet in your MCP client configuration (e.g., Claude Desktop):
```json
{"command": "python", "args": ["-m", "bitbucket_mcp_server.server_fastmcp"], "cwd": "."}
```
## Container
Build and run with a local container runtime (Docker/Podman):
```bash
# Build
podman build -f Containerfile -t bitbucket-mcp-server:0.1.0 .
# Run
podman run --rm -it bitbucket-mcp-server:0.1.0
```
## License
Apache-2.0
