Laravel Boost’u DDEV ile Kullanma

Giriş

Laravel Boost, Laravel uygulamanız hakkında AI kodlama ajanlarına derin bir bağlam sağlayan resmi bir MCP sunucusudur. Rotalar, şemalar, günlükler, yapılandırmalar ve daha fazlası ile çalışır. DDEV ile geliştirme yapıyorsanız, Boost konteyner içinde çalışır ve düzenleyiciniz yalnızca ona nasıl erişeceğini bilmelidir.

Bu makale, standart DDEV kurulumu ve WSL için gerekli ek adımı ele alacaktır.

Gereksinimler

• DDEV üzerinde çalışan bir Laravel projesi
• MCP’yi destekleyen bir düzenleyici (Cursor, VS Code ile Copilot, Claude Code vb.)

Boost Kurulumu

Proje kök klasörünüzden şu komutları çalıştırın:

ddev composer require laravel/boost --dev
ddev artisan boost:install

Kurulum komutu, seçtiğiniz AI ajanı için kılavuz ve beceri dosyaları oluşturur. Bu dosyaları .gitignore dosyanıza ekleyebilirsiniz, çünkü boost:install bunları yeniden oluşturacaktır.

MCP Sunucusunu Yapılandırma

Standart Kurulum (Linux / macOS)

Proje kök klasörünüzde bir .mcp.json dosyası oluşturun:

{
    "mcpServers":
    {
        "laravel-boost":
        {
            "command": "ddev",
            "args": [
                "artisan",
                "boost:mcp"
            ]
        }
    }
}

Bitti. DDEV, ddev artisan komutunu ddev exec php artisan için bir kısayol olarak sunar, böylece yapılandırma minimum düzeyde kalır. Bu komut, konteyner içinde boost:mcp‘yi çalıştırır ve düzenleyicinize stdio üzerinden açar.

WSL Kurulumu (Windows)

Düzenleyiciniz Windows’da çalışıyorsa ancak DDEV projeniz WSL’de ise, düzenleyiciniz ddev‘yi doğrudan çağıramaz. Komutu wsl.exe ile sarın ve cwd‘yi WSL proje yoluna yönlendirin:

{
    "mcpServers":
    {
        "laravel-boost":
        {
            "command": "wsl.exe",
            "args": [
                "ddev",
                "artisan",
                "boost:mcp"
            ],
            "cwd": "/home/your-user/dev/your-project"
        }
    }
}

wsl.exe, Windows’dan varsayılan WSL dağıtımınıza köprü işlevi görür, burada ddev PATH’te mevcuttur. cwd, hangi dizinde çalışacağını belirtir, böylece DDEV doğru projeyi alır.

Eğer varsayılan olmayan bir dağıtım kullanıyorsanız, args dizisinde -d your-distro ifadesini ddev‘den önce ekleyin.

Doğruluğunu Kontrol Et

Düzenleyicinizi açın ve AI ajandan bir proje spesifik sorusu sorun, örneğin “Bu uygulamanın hangi rotaları var?” veya “Veritabanı şemasını göster.” Eğer Boost bağlıysa, ajan, gerçek uygulama durumunuzdan yanıt verecektir.

Ayrıca mevcut araçları direkt olarak kontrol edebilirsiniz. Claude Code’da:

claude mcp list

laravel-boost‘ın 15’ten fazla aracıyla listeleneceğini görmelisiniz.

Boost’u Güncel Tutma

Laravel veya bağımlılıklarını güncellemeniz gerektiğinde:

ddev composer update laravel/boost
ddev artisan boost:update

Ya da otomatikleştirmek için boost:update‘i Composer post-update-cmd betiğine ekleyebilirsiniz.