mcp-unlock-pdf

MCP server to give client the ability read protected (or un-unprotected) PDF Works with large PDFs by extracting text to temp file.

Forked from the excellent upstream project https://github.com/algonacci/mcp-unlock-pdf

Published to pypi.

Usage

uvx mcp-read-pdf

Will run from pypi. This can be used in goose or claude.

Test

uv run python main.py --test

Usage from source

Running from cli (Goose, or to try it)

uv --directory /Users/micn/Documents/code/extractorb-py/mcp-unlock-pdf run python main.py

Building and Publishing

1. Update version in pyproject.toml:

[project]
version = "x.y.z"  # Update this

2. Build the package:

# Clean previous builds
rm -rf dist/*


# Or build in a clean environment using uv
uv venv .venv
source .venv/bin/activate
uv pip install build
python -m build

3. Publish to PyPI:

# Install twine if needed
uv pip install twine

# Upload to PyPI
python -m twine upload dist/*