Laravel 12 Docs MCP Server
A Model Context Protocol server that provides AI assistants and language models with access to Laravel 12 documentation, allowing them to list, read, and search through documentation files.
README Documentation
Laravel MCP Companion
formerly Laravel Docs MCP Server
⚠️ BETA SOFTWARE - This project is in early development. Features may not work as expected and breaking changes may occur without notice.
Laravel MCP Companion is a comprehensive documentation aggregator and navigator for the Laravel ecosystem. Rather than generating content, it centralizes and organizes existing high-quality documentation from across the Laravel ecosystem, making it easily discoverable through your AI assistant.
Why Laravel MCP Companion?
| Feature | Laravel MCP Companion | Context7 |
|---|---|---|
| Instant documentation retrieval (zero latency) | ✅ | ❌ |
| Laravel multi-version support (6.x - latest) | ✅ | ❌ |
| Laravel service docs (Forge, Vapor, Nova, Envoyer) | ✅ | ❌ |
| Curated Laravel package recommendations | ✅ | ❌ |
| Offline documentation access | ✅ | ❌ |
| Pre-processed markdown (saves tokens) | ✅ | ❌ |
| No internet requests during use | ✅ | ❌ |
| Laravel-specific search | ✅ | ❌ |
| Auto-discovery of service docs | ✅ | ❌ |
| General documentation (non-Laravel) | ❌ | ✅ |
While Context7 excels at general documentation retrieval, Laravel MCP Companion is purpose-built for Laravel developers with faster, offline-capable, Laravel-specific features.
What you get:
- Multi-version Laravel documentation (6.x through latest) with enhanced search
- Auto-discovery Laravel services - Forge, Vapor, Envoyer, Nova (117+ sections)
- Community package documentation - 42,000+ lines from Spatie, Livewire, Inertia, Filament
- Use case mapping - Describe what you need, get relevant packages instantly
- Package integration guides - Installation and setup for 50+ curated packages
- Cross-package compatibility - Learn which packages work well together
- Unified search across core Laravel docs, services, and packages
- Smart navigation - find exactly what you need for your use case
- Future-proof updates - automatically adapts to Laravel service changes
Auto-Discovery & Update Frequency
This application features an intelligent auto-discovery system that automatically finds and indexes Laravel documentation. Every day, it:
- ✅ Auto-discovers new documentation sections across Laravel services (Forge, Vapor, Nova, Envoyer)
- ✅ Retrieves the latest Laravel core documentation for all versions since 6.x
- ✅ Fetches community package documentation (Spatie, Livewire, Inertia, Filament)
- ✅ Adapts automatically to structural changes in documentation websites
- ✅ Generates new patch releases automatically when updates are found
Installation
Quick Install via Smithery
npx -y @smithery/cli install @brianirish/laravel-mcp-companion --client claude
Note: Smithery automatically configures your AI client.
Claude Desktop
-
Open Claude Desktop Settings
- Click Claude menu → Settings → Developer → Edit Config
-
Add to your configuration file:
{ "mcpServers": { "laravel-mcp-companion": { "command": "docker", "args": ["run", "--rm", "-i", "ghcr.io/brianirish/laravel-mcp-companion:latest"] } } } -
Restart Claude Desktop for changes to take effect
Config file locations:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code
Use the claude mcp add command:
# Add with Docker
claude mcp add laravel-mcp-companion docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest
# Or add to project-specific config (for team sharing)
claude mcp add laravel-mcp-companion docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --scope project
The --scope project option creates a .mcp.json file in your project root that can be committed to version control.
Configuration Options
These options can be used with the Docker command. For example:
# Update docs for Laravel 11.x only
docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --version 11.x
# Force update all documentation
docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --force-update
| Option | Description | Default |
|---|---|---|
--version VERSION | Laravel version (e.g., "12.x", "11.x") | Latest |
--docs-path PATH | Documentation directory | ./docs |
--log-level LEVEL | DEBUG, INFO, WARNING, ERROR, CRITICAL | INFO |
--update-docs | Update documentation on startup | false |
--force-update | Force documentation update | false |
Features and Roadmap
Current Features (v0.8.0)
- ✅ Multi-version Laravel docs - All versions from 6.x to latest
- ✅ Auto-discovery engine - Finds new docs across Forge, Vapor, Nova, Envoyer
- ✅ Community package docs - 42,000+ lines from Spatie, Livewire, Inertia, Filament
- ✅ Use case mapping - Describe what you need, get relevant packages
- ✅ Package integration guides - Installation and setup for 50+ packages
- ✅ Cross-package compatibility - Documentation for package combinations
- ✅ Unified search - One search across all documentation sources
- ✅ Daily updates - Automatic sync with latest documentation
- ✅ Battle-tested - Comprehensive test suite ensures reliability
Upcoming Features
- 📰 v0.9.0: Laravel News, Bootcamp, tutorials, and advanced discovery
- 🔍 v0.10.0: Ecosystem intelligence and real-time updates
- 🚀 v1.0.0: The complete Laravel documentation navigator
For detailed roadmap information, see ROADMAP.md.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
Acknowledgements
- Laravel for their excellent documentation
- Laravel package authors for their contributions to the ecosystem