MCP 服务器

Laravel MCP Companion

Provides instant access to comprehensive Laravel ecosystem documentation including multi-version core docs (6.x-latest), Laravel services (Forge, Vapor, Nova, Envoyer), and 42,000+ lines of community package documentation with intelligent search and use-case mapping.

README

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