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

Laravel MCP 助手