Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Laravel MCP Companion

de brianirishversión 1.0.0-rc1i★ 38iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.brianirish/laravel-mcp-companion

Cómo instalar

What it does

Laravel docs for every version from 6.x to 13.x, plus services and packages, kept local and offline.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Otros

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad19/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso31/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Laravel MCP Companion. Sigue https://mcp.popnx.com/i/brianirish-laravel-mcp-companion.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 19 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Laravel MCP Companion para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "laravel-companion": { "command": "uvx", "args": [ "laravel-mcp-companion" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Laravel MCP Companion aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "laravel-companion": {
          "command": "uvx",
          "args": [
            "laravel-mcp-companion"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Laravel MCP Companion y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Laravel MCP Companion o muestra una herramienta de Laravel MCP Companion en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Laravel MCP Companion

Laravel MCP Companion se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Laravel MCP Companion

  • Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Python (uv) en tu computadora primero (una sola vez)
  • Instala Python (uv) en tu computadora primero (una sola vez)
  • Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Otros que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Laravel MCP Companion para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user laravel-companion -- uvx laravel-mcp-companion 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Laravel MCP Companion aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user laravel-companion -- uvx laravel-mcp-companion
  4. Escribe /mcp en Claude Code

    Deberías ver Laravel MCP Companion en la lista como conectado

  5. Pruébalo

    Usa Laravel MCP Companion y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Laravel MCP Companion o muestra una herramienta de Laravel MCP Companion en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Laravel MCP Companion para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "laravel-companion": { "command": "uvx", "args": [ "laravel-mcp-companion" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Laravel MCP Companion aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Laravel MCP Companion y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Laravel MCP Companion o muestra una herramienta de Laravel MCP Companion en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Laravel MCP Companion para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "laravel-companion": { "type": "stdio", "command": "uvx", "args": [ "laravel-mcp-companion" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Laravel MCP Companion aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Laravel MCP Companion y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Laravel MCP Companion o muestra una herramienta de Laravel MCP Companion en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Laravel MCP Companion💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user laravel-companion -- uvx laravel-mcp-companion

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "laravel-companion": {
      "command": "uvx",
      "args": [
        "laravel-mcp-companion"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "laravel-companion": {
      "command": "uvx",
      "args": [
        "laravel-mcp-companion"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "laravel-companion": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "laravel-mcp-companion"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en tu computadora
Última versióni
1.0.0-rc1
Categoríai
Otros
Publicado en el registroi
19 nov 2026
Último cambio de códigoi
19 nov 2026
Creador
brianirish
Paquetes
oci: ghcr.io/brianirish/laravel-mcp-companion:v1.0.0-rc1
pypi: laravel-mcp-companion
Sitio web
github.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub brianirish, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para laravel-mcp-companion@1.0.0rc1

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 19 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/brianirish-laravel-mcp-companion.svg)](https://mcp.popnx.com/en/servers/brianirish-laravel-mcp-companion)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 98% de los otros 20815 servidores de esta categoría
  • Publicado en el registro más recientemente que el 98% de los otros 20815 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 20815 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Laravel MCP Companion?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (1.0.0-rc1) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker, Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

de koala73Muy usado★ 90,9 milActualizado hace 4 días

Se ejecuta en la nube✓ del servicio · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 31 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com
Comparado con otros parecidos
Este
Laravel MCP Companion
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/44/44/41/44/4
LicenciaMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Laravel MCP Companion

Every Laravel version, the whole ecosystem, fully local.

Laravel MCP Companion is an MCP server that keeps Laravel's documentation on your machine and lets an AI assistant search and read it. It holds the framework docs for every version from 6.x to the newest, the first-party services, and widely used packages. Nothing is fetched while you work, so it answers without a network connection.

Status: 0.15 is a breaking release. The tools it introduces, with their arguments and

results, are the ones 1.0 will promise not to break.

MIGRATING.md lists what changed for anyone upgrading.

A reference library

Three things set it apart:

  • Every version, side by side. Laravel 6.x through 13.x are all held. Ask about the version an older application runs on, or compare two versions to see what an upgrade brings.
  • Fully local. The documentation ships inside the image or the Python package. Nothing leaves your machine and no vendor API is called, so it works offline and behind an air gap.
  • It needs no project. It works in a chat client with no code open, where there is no composer.lock to read.

Laravel Boost is the first-party tool for writing code inside a Laravel project: it is installed into the application and knows what the application uses. Use Boost while building. Use Companion to look something up in any Laravel version, in a client with no project open, or where the documentation has to stay on the machine.

Documentation held

  • The framework documentation for Laravel 6.x through 13.x.
  • First-party services: Forge, Vapor, Envoyer, Nova, Cloud, Nightwatch and Herd.
  • Packages: Livewire, Filament, Inertia, and Spatie's Permission, Media Library and Backup, each at its current major version, plus Debugbar and IDE Helper.
  • Learning material: the courses at laravel.com/learn and an index of Laracasts topics.
  • A hand-written catalog of 42 curated packages: what each is for, how to install it, what goes with it, and which ones newer projects no longer start with.

The project refetches all of it every night and publishes a new image, so you get newer documentation by pulling one; nothing is fetched on your machine unless you ask for an update. Ask your assistant how current its documentation is, or call laravel_docs_info, to see the date and page count of every source.

Installation

Listed in the official MCP Registry as io.github.brianirish/laravel-mcp-companion — clients with registry support can install it from there directly. Manual setup:

Claude Desktop
  1. Open Claude Desktop Settings
  • Click Claude menu → Settings → Developer → Edit Config
  1. Add to your configuration file:
   {

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

  1. 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 --scope project -- docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest

The --scope project option creates a .mcp.json file in your project root that can be committed to version control.

Without Docker

The project is also an ordinary Python package (3.12+), with the documentation bundled, so it runs without Docker and without a network connection. It is not on PyPI yet; install it from the repository:

# Run it without installing anything permanently

uvx --from git+https://github.com/brianirish/laravel-mcp-companion laravel-mcp-companion

Or install it

pip install git+https://github.com/brianirish/laravel-mcp-companion laravel-mcp-companion

In an MCP client config, use uvx as the command and ["--from", "git+https://github.com/brianirish/laravel-mcp-companion", "laravel-mcp-companion"] as the arguments. The options in the next section are passed the same way, after laravel-mcp-companion.

An install made this way (with uvx or pip) carries the documentation as it was on the day you installed it. Starting the server with --update-docs fetches the current documentation and stores it in a per-user directory, where a reinstall or an upgrade does not touch it:

SystemDirectory
macOS~/Library/Application Support/laravel-mcp-companion/docs
Linux~/.local/share/laravel-mcp-companion/docs (or under $XDG_DATA_HOME)
Windows%LOCALAPPDATA%\laravel-mcp-companion\docs

To keep it elsewhere, set LARAVEL_MCP_COMPANION_HOME to a directory; the documentation goes in docs inside it. The server compares that directory with the documentation that came with the installed version and reads the newer of the two. Delete the directory to return to the documentation that came with the install.

The Docker image, and a clone of this repository, hold one copy of the documentation and update it in place.

Configuration Options

Options go after the image name in the Docker command, or after laravel-mcp-companion. For example:

# Pin to a specific older Laravel version

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

OptionDescriptionDefault
--version VERSIONLaravel version answered from by default, e.g. 11.x (env: VERSION)The newest
--docs-path PATHDocumentation directory (env: DOCS_PATH)The copy that ships with the image or package, or your updated copy if it is newer
--transport TRANSPORTstdio, or http to serve over HTTP (env: TRANSPORT)stdio
--port PORTPort for the HTTP transport (env: PORT)8081
--server-name NAMEName the server reports to clients (env: SERVER_NAME)LaravelMCPCompanion
--log-level LEVELDEBUG, INFO, WARNING, ERROR, CRITICAL (env: LOG_LEVEL)INFO
--update-docsUpdate documentation on startupfalse
--force-updateForce documentation updatefalse
--transform-mode MODETool exposure mode: search, code, or none (env: TRANSFORM_MODE)search
--host HOSTInterface to bind in HTTP mode (env: HOST)127.0.0.1 (0.0.0.0 in Docker)
--cors-origin ORIGINBrowser origin allowed to call the HTTP transport, repeatable (env: CORS_ORIGINS)none (CORS off)
--allowed-host HOSTAdditional Host header accepted in HTTP mode, repeatable (env: ALLOWED_HOSTS)localhost, 127.0.0.1, ::1
--auth-jwks-uri URIJWKS endpoint enabling bearer-token auth in HTTP mode (env: AUTH_JWKS_URI)none (auth off)
--auth-issuer ISSUERRequired token issuer, with --auth-jwks-uri (env: AUTH_ISSUER)none
--auth-audience AUDRequired token audience, with --auth-jwks-uri (env: AUTH_AUDIENCE)none
--auth-required-scope SCOPEScope every token must carry, repeatable (env: AUTH_REQUIRED_SCOPES)none
--rate-limit RPSMCP requests/second accepted in HTTP mode; operational endpoints are never limited (env: RATE_LIMIT_RPS)none (no limiting)
--rate-limit-burst NToken-bucket burst capacity (env: RATE_LIMIT_BURST)max(10, 2×RPS)
Keeping documentation current

Documentation ships inside the image, and a new image is published whenever the documentation is refreshed. Which documentation you get depends on the tag:

TagCodeDocumentation
:latestthe newest releaserefreshed nightly
:v0.15.0 and other version tagsthat releaseas it was on the release date
:docs-YYYY-MM-DDthe newest release as of that date (tags from before 0.15 carry whatever was on main)that night's sync

:latest never carries unreleased code: the nightly image is the newest release with that night's documentation.

The catch is that `docker run` reuses the copy you already have — once you've pulled the image, you keep running it until you pull again. Refresh whenever you like:

docker pull ghcr.io/brianirish/laravel-mcp-companion:latest

Or add --pull=always to your MCP config so every start checks for a newer image. It costs a moment of startup time and needs a working connection, so it's opt-in rather than the default:

"args": ["run", "--rm", "-i", "--pull=always",

"ghcr.io/brianirish/laravel-mcp-companion:latest"]

You don't have to track this yourself. The server tells your assistant how old the documentation is for the Laravel version it's serving, so if you ask about something newer than that snapshot it will say so and offer to refresh instead of answering from stale pages. You can also just ask — *"how current are your Laravel docs?"*

To update in place without pulling a new image, --update-docs fetches fresh documentation for the selected Laravel version during startup. Your assistant can refresh any source while the server runs with the update_laravel_docs tool, whose scope selects the framework docs, the services, the packages or all of them.

With --rm the download is discarded when the container exits, so it repeats on every start. A named volume keeps it — but note the trade-off:

docker run --rm -i -v laravel-mcp-docs:/app/docs \

ghcr.io/brianirish/laravel-mcp-companion:latest --update-docs

The server runs as an unprivileged user (uid 10001), which owns /app/docs in the image, so a new named volume is writable. Images before 0.15 ran as root, and a volume one of them created is owned by root: remove it (docker volume rm laravel-mcp-docs) and let the next run recreate it.

A volume overrides the image's documentation. Once populated it masks

/app/docs, so pulling a newer image no longer updates what the server reads —

the volume becomes your source of truth and --update-docs becomes the way you

refresh it. Use a volume when you want to control updates explicitly; stick to

plain docker pull if you'd rather the image stay in charge.

Transform Modes

The server is built on FastMCP, which can put a small search interface in front of a server's tools so that their descriptions do not all sit in the client's context. That is the default here, so a client lists four tools, not twelve:

  • `search` (default) — Lists search_tools, which finds a tool from a description of what you need, and call_tool, which runs any tool by name. search_laravel_docs and read_laravel_doc_section are listed directly as well, since

Solo se muestra el principio; lee el resto en el repo