digdir-chunker

This application provides a JSON REST API and MCP tools for converting PDF and other documents to paginated and chunked Markdown.

The service takes a URL to a document as input and returns a document ID which can be used as a parameter for polling the conversion status and retrieving the converted and chunked document when it has been processed.

Development and deployment

Create an environment file and make any eventual configuration changes (e.g. change APP_ENV from local to production for deployment).

cp .env.example .env

Start the application and required services:

docker-compose up -d

Install dependencies:

docker compose exec app composer install

Set the application key:

docker compose exec app php artisan key:generate

Run database migrations:

docker compose exec app php artisan migrate

Restart queues:

docker compose exec app php artisan queue:restart

The application should now be up and running on localhost port 80 by default.

MCP setup

The HTTP transport MCP server is available at http://localhost/mcp by default.

The MCP server can also be run locally using the stdio transport. Replace <path-to-digdir-chunker> with the absolute path to this repo in this example config:

{
    "mcpServers": {
        "digdir-chunker": {
            "command": "/usr/local/bin/docker",
            "args": [
                "compose",
                "-f",
                "<path-to-digdir-chunker>/docker-compose.yml",
                "exec",
                "-T",
                "app",
                "php",
                "artisan",
                "mcp:serve",
                "--transport=stdio"
            ]
        }
    }
}

Common commands

Restart the queue (required after code changes that affect jobs)

docker compose exec app php artisan queue:restart

Reset the database (delete tables, run migrations and seed the database with default data)

docker compose exec app php artisan migrate:refresh --seed

List all available commands:

docker compose exec app php artisan list

REST API documentation

API documentation is automatically generated and published at /docs/api.

Maintenance

Dependencies should be regularly updated by running:

composer update
yarn upgrade

and committing changes in composer.json and yarn.json.

Tech stack

• PHP (php-fpm)
• Laravel framework
• MariaDB
• Nginx
• Marker