workshop -laravel

This MCP server represents a Laravel workshop project that you can run locally using Docker Compose. The repository demonstrates how to set up and interact with a Laravel-based API and front-end workshop slides. To exercise the workshop, start the Docker services, install dependencies, and prepare the Laravel application (keys and database) as described in the demo steps. Once the services are up, you can access the API endpoints and follow along with the provided slides to learn how to consume the API from a Laravel context or any client that can make HTTP requests.

The main capabilities include: spinning up the workshop environment via Docker Compose, generating an application key, running migrations with seeds, and interacting with Laravel Artisan commands inside the running container. The flow mirrors a typical Laravel API project setup, so you can experiment with database seeding, migrations, and artisan tooling while following the slides.

Prerequisites:

• Docker and Docker Compose installed on your system
• Git installed

Install steps:

1. Clone the repository (recursively to fetch submodules if any): git clone --recursive git@github.com:vcampitelli/workshop-mcp-laravel.git

2. Navigate to the project directory and start the workshop services using Docker Compose: cd workshop-mcp-laravel docker compose up -d

3. Prepare the Laravel application inside the container (example commands shown in the Demo section): docker compose exec api php artisan key:generate docker compose exec api php artisan migrate --seed

4. Open the slides in your browser by navigating to the appropriate local URL as described in the Slides section of the repository.

Note: If the project requires environment configuration, copy the example env file and adjust database credentials as needed (for example, cp .env.example .env and then docker compose exec api php artisan key:generate).

Tips and common issues:

• Ensure Docker Daemon is running before executing docker compose commands.
• If you encounter permission issues with SSH keys when cloning, use HTTPS clone or configure SSH agent appropriately.
• The Laravel setup relies on the api service in the docker-compose configuration. If the service name differs (e.g., 'laravel-api'), adjust the docker compose exec command accordingly.
• If migrations fail due to database connection, verify the database container is healthy and the .env configuration matches the container service name and credentials.
• You can stop the workshop at any time with docker compose down. If you need to rebuild containers after changing code, use docker compose down --rmi local and then up again.
• This MCP configuration uses Docker Compose; no npm, Python, or Node dependencies are required for running the workshop as described.