apdf-cloud-cli 0.1.0

CLI and MCP server tools for Aspose PDF Cloud

APDF Cloud CLI + MCP Tools

Stage 1 exposes APDF storage and PDF operations through both a CLI and an MCP server.

Configuration

Set credentials before running CLI commands or the MCP server:

$env:ASPOSE_CLIENT_ID = "your-client-id"
$env:ASPOSE_CLIENT_SECRET = "your-client-secret"

Optional environment variables:

• ASPOSE_BASE_URL
• ASPOSE_SELF_HOST
• ASPOSE_STORAGE_NAME

CLI

The canonical executable is apdf-cloud-cli. A shorter apdf alias is also installed for convenience.

apdf-cloud-cli storage list /
apdf-cloud-cli storage upload .\sample.pdf /sample.pdf
apdf-cloud-cli storage download /sample.pdf .\sample.pdf
apdf-cloud-cli pdf merge /a.pdf /b.pdf merged.pdf
apdf-cloud-cli pdf extract-text sample.pdf --output sample.txt
apdf-cloud-cli mcp serve

Development

Install the package with development dependencies:

python -m pip install -e ".[dev]"

Run the default test suite:

python -m pytest -q

Build and validate the package distributions:

python -m build
python -m twine check dist/*

Publishing

Publishing is handled by GitHub Actions with PyPI trusted publishing.

1. In PyPI, add a trusted publisher for repository andruhovski/apdf-tools, workflow publish.yml, environment pypi, and project name apdf-cloud-cli.
2. Update the version in pyproject.toml and src/apdf_cloud_cli/__init__.py.
3. Push a matching version tag, for example:

git tag v0.1.0
git push origin v0.1.0

Stage 2 Roadmap

• Split PDF files
• Extract images from PDF files
• Extract tables from PDF files