Laravilt MCP Server

Laravilt MCP

A public, read-only Model Context Protocol server that gives AI assistants the latest Laravilt documentation, READMEs, changelogs and released versions of every laravilt/* package, including the plugin system and the Vue/React frontends.

Endpoint: https://mcp.laravilt.com/mcp (streamable HTTP, no authentication, rate limited per IP).

Connect

Claude Code

claude mcp add --transport http laravilt https://mcp.laravilt.com/mcp

Cursor / VS Code (.cursor/mcp.json or .vscode/mcp.json)

{
    "mcpServers": {
        "laravilt": { "type": "http", "url": "https://mcp.laravilt.com/mcp" }
    }
}

Claude Desktop (through mcp-remote)

{
    "mcpServers": {
        "laravilt": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.laravilt.com/mcp"] }
    }
}

Any other client: use the streamable HTTP URL https://mcp.laravilt.com/mcp.

Tools

Resources: laravilt://packages and laravilt://docs/{package}/{path} for every synced document. Prompt: build-resource.

How content stays current

php artisan laravilt:sync scans the laravilt GitHub organization, downloads each package's default branch as a tarball, indexes README.md, CHANGELOG.md, composer.json and every Markdown file under docs/, and records released versions from Packagist. Unchanged commits are skipped. The scheduler runs it every 30 minutes, and a GitHub webhook (POST /webhooks/github, signed with GITHUB_WEBHOOK_SECRET) queues a sync of the pushed repository immediately.

Local development

composer install
cp .env.example .env && php artisan key:generate
touch database/database.sqlite
php artisan migrate
php artisan laravilt:sync
php artisan serve

Then open http://127.0.0.1:8000 for the landing page, or point an MCP client at http://127.0.0.1:8000/mcp.

php artisan test
vendor/bin/pint

Configuration

Deployment

1. composer install --no-dev --optimize-autoloader, create .env from .env.example, php artisan key:generate, php artisan migrate --force.
2. Run php artisan laravilt:sync once.
3. Run the scheduler every minute (php artisan schedule:run) and a queue worker for webhook-triggered syncs (php artisan queue:work, or QUEUE_CONNECTION=sync).
4. Serve public/ with PHP-FPM behind your web server or reverse proxy, and set TRUSTED_PROXIES.
5. In each Laravilt repository (or the organization), add a webhook to https://mcp.laravilt.com/webhooks/github for push events, using the same secret.

License

MIT