mpak 0.1.0

Python SDK for the mpak registry - MCPB bundles and Agent Skills

mpak Python SDK

Python SDK for the mpak registry - search, download, and resolve MCPB bundles and Agent Skills.

Installation

pip install mpak

Quick Start

from mpak import MpakClient

# Create client
client = MpakClient()

# Resolve a bundle to download URL
download = client.get_bundle_download("@nimblebraininc/echo", version="latest")
print(f"Download URL: {download.url}")
print(f"SHA256: {download.sha256}")

# Download and extract a bundle
manifest = client.load_bundle("@nimblebraininc/echo", dest="/app/bundle")
print(f"Loaded: {manifest['name']} v{manifest['version']}")

CLI Usage

The package provides a mpak-loader CLI that replaces the standalone mcpb-loader.py script:

# Load from mpak registry
mpak-loader @nimblebraininc/echo /dest/dir

# Load specific version
mpak-loader @nimblebraininc/echo@1.0.0 /dest/dir

# Load from direct URL with SHA256 verification
mpak-loader https://example.com/bundle.mcpb /dest/dir abc123...

Development

Setup

# Install with dev dependencies
uv pip install -e ".[dev]"

# Generate types from OpenAPI spec
python scripts/generate-types.py

Testing

# Run tests
pytest

# Run with coverage
pytest --cov=mpak --cov-report=html

# Lint and format
ruff check .
ruff format .

Type Generation

The SDK types are generated from the mpak registry OpenAPI spec. To regenerate:

python scripts/generate-types.py

This fetches the latest spec from https://registry.mpak.dev/docs/json and generates Pydantic models in src/mpak/generated/types.py.

License

Apache-2.0