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
- Community package documentation - Spatie, Livewire, Inertia, Filament
- Curated package recommendations with detailed integration guides
- 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
- ✅ 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 - Documentation for Spatie, Livewire, Inertia, Filament
- ✅ Smart package recommendations - Curated Laravel ecosystem packages
- ✅ 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.8.0: Community learning resources (Laravel News, tutorials, guides)
- 🔍 v0.9.0: Advanced search and smart navigation across all sources
- 🚀 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