laravel-forge-mcp

Servidor MCP de Laravel Forge — cobertura completa de la API v2 de Forge para asistentes de IA mediante el Model Context Protocol.

Este servidor utiliza los endpoints oficiales JSON:API v2 (https://forge.laravel.com/api). No utiliza la API v1 heredada (/api/v1).

Características

• ~270 herramientas que cubren servidores, sitios, despliegues, bases de datos, copias de seguridad, PHP, servicios, equipos, roles, recetas y más

• Paginación por cursor, filtrado, ordenación e inclusión de relaciones

• Reintento automático por límite de peticiones (429 + Retry-After)

• Rutas con ámbito de organización y organización predeterminada opcional mediante FORGE_ORGANIZATION

Related MCP server: Forge MCP Server

Requisitos

• Node.js >= 20

• Un token de API de Forge

Variables de entorno

FORGE_API_KEY se acepta como alias silencioso de FORGE_API_TOKEN.

Instalación

Cursor

Añádelo a tu configuración de usuario (~/.cursor/mcp.json) o a la configuración del proyecto (.cursor/mcp.json):

{
  "mcpServers": {
    "laravel-forge-mcp": {
      "command": "npx",
      "args": ["-y", "@vitrion/laravel-forge-mcp"],
      "env": {
        "FORGE_API_TOKEN": "your-forge-api-token",
        "FORGE_ORGANIZATION": "your-org-slug"
      }
    }
  }
}

También puedes añadir el servidor desde Cursor Settings → Tools & MCP.

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "laravel-forge-mcp": {
      "command": "npx",
      "args": ["-y", "@vitrion/laravel-forge-mcp"],
      "env": {
        "FORGE_API_TOKEN": "your-forge-api-token",
        "FORGE_ORGANIZATION": "your-org-slug"
      }
    }
  }
}

Claude Code

claude mcp add laravel-forge-mcp -- npx -y @vitrion/laravel-forge-mcp

Establece FORGE_API_TOKEN (y opcionalmente FORGE_ORGANIZATION) en tu entorno de shell o en la configuración del host MCP.

Grupos de herramientas

Las herramientas se nombran en kebab-case y se corresponden uno a uno con las operaciones de la API v2 de Forge:

Las herramientas de listado admiten parámetros de consulta compartidos: include, filter, sort, pageSize y cursor.

Desarrollo

git clone https://github.com/vitrionbv/laravel-forge-mcp.git
cd laravel-forge-mcp
npm install
npm run build
npm test
npm run dev

Inspector

Depura el servidor MCP con el inspector oficial (requiere una compilación de dist/):

npm run build
npm run inspector

O directamente:

npx @modelcontextprotocol/inspector node dist/index.js

Licencia

MIT — consulta LICENSE.

Repositorio

vitrionbv/laravel-forge-mcp