laravel-forge-mcp

Laravel Forge MCP server – vollständige Abdeckung der Forge API v2 für KI-Assistenten über das Model Context Protocol.

Dieser Server verwendet die offiziellen JSON:API-v2-Endpunkte (https://forge.laravel.com/api). Er verwendet nicht die veraltete v1-API (/api/v1).

Funktionen

• ~270 Tools für Server, Sites, Deployments, Datenbanken, Backups, PHP, Dienste, Teams, Rollen, Rezepte und mehr

• Cursor-Paginierung, Filterung, Sortierung und Einbindung von Beziehungen

• Automatische Wiederholung bei Rate-Limit (429 + Retry-After)

• Organisationsbezogene Endpunkte mit optionaler Standardorganisation über FORGE_ORGANIZATION

Related MCP server: Forge MCP Server

Voraussetzungen

• Node.js >= 20

• Ein Forge-API-Token

Umgebungsvariablen

FORGE_API_KEY wird als stiller Alias für FORGE_API_TOKEN akzeptiert.

Installation

Cursor

Fügen Sie den Server zu Ihrer Benutzerkonfiguration (~/.cursor/mcp.json) oder Ihrer Projektkonfiguration (.cursor/mcp.json) hinzu:

{
  "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"
      }
    }
  }
}

Sie können den Server auch über Cursor-Einstellungen → Tools & MCP hinzufügen.

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

Setzen Sie FORGE_API_TOKEN (und optional FORGE_ORGANIZATION) in Ihrer Shell-Umgebung oder in der MCP-Host-Konfiguration fest.

Tool-Gruppen

Die Tools sind in kebab-case benannt und bilden die Operationen der Forge API v2 eins zu eins ab:

Listen-Tools unterstützen gemeinsame Query-Parameter: include, filter, sort, pageSize und cursor.

Entwicklung

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

Debuggen Sie den MCP-Server mit dem offiziellen Inspector (erfordert ein gebautes dist/):

npm run build
npm run inspector

Oder direkt:

npx @modelcontextprotocol/inspector node dist/index.js

Lizenz

MIT – siehe LICENSE.

Repository

vitrionbv/laravel-forge-mcp