home / mcp / laravel mcp companion mcp server

Laravel MCP Companion MCP Server

A Laravel developer's MCP companion. Get the absolute best advice, recommendations, and up-to-date documentation for the entire Laravel ecosystem.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "brianirish-laravel-mcp-companion": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/brianirish/laravel-mcp-companion:latest"
      ]
    }
  }
}

Laravel MCP Companion centralizes Laravel documentation by aggregating multi-version core docs, services, and community package references. It helps you learn faster, discover relevant material, and use Laravel resources more efficiently with an MCP client.

How to use

You connect to the MCP server through an MCP client by adding the server configuration and starting the local or remote service. Once connected, you can search across Laravel core docs, Forge, Vapor, Envoyer, Nova, and popular packages, then use learning paths, “I need X” style queries, and cross-package guidance to find the exact documentation you need. You can also filter content by difficulty, browse by topic category, and access up-to-date materials from multiple Laravel sources in a single interface.

How to install

Prerequisites: You need Docker installed on your system to run the MCP companion through the provided container.

Install and run the MCP companion using the supported runtime command shown below. This setup runs the MCP companion as a local process via Docker.

Configuration and usage notes

The MCP server is configured to run as a local process via Docker. When you start it, the companion serves as a backend that your MCP client connects to for aggregated Laravel documentation.

Development

If you are contributing, you can build, test, and run the project using Python 3.12+, and Node.js 18+ for auxiliary tooling. Set up a virtual environment, install dependencies, and run tests or start the MCP Inspector for manual testing of the server.

Notes

This MCP server focuses on providing an integrated Laravel documentation experience with multi-version support, learning paths, and curated package content. Use the MCP client to explore and retrieve relevant documentation efficiently.

Available tools

Learning paths

Structured sequences that guide you through topics at beginner, intermediate, and advanced levels.

I need X finder

Natural language prompts to locate the most relevant documentation across Laravel core, services, and packages.

Cross-package guidance

Recommendations on which packages work well together and how to integrate them.

Package installation guides

Step-by-step setup for popular Laravel packages to help you get started quickly.

Unified search

A single search across core docs, services, and packages to streamline discovery.

Auto-discovery of documentation

Automatically indexes new docs from Laravel services and community packages.

Learning content categorization

Topics organized into semantic categories with filters by difficulty.

Daily updates

Automatic synchronization with the latest documentation and changes.