🚀 Laravel MCP Server

AI-Powered Laravel Development Assistant — Secure bridge between AI Clients (Claude Desktop, Cursor, VS Code) and your local Laravel projects.

<div align="center">

</div>

---

📖 Table of Contents

• What is Laravel MCP Server?
• Features
• Security Architecture
• Installation
• Quick Start
• Configuration
• Usage Examples
• Tools Reference
• Security Details
• Troubleshooting
• Contributing
• License

---

🎯 What is Laravel MCP Server?

Laravel MCP Server adalah MCP (Model Context Protocol) Server berbasis TypeScript/Node.js yang memungkinkan AI Assistant seperti Claude untuk:

• ✅ Menjalankan perintah php artisan dengan aman
• ✅ Membaca dan menganalisis Laravel logs
• ✅ Melihat routes, config, dan structure proyek
• ✅ Membaca dan menulis source code (dengan proteksi ketat)
• ✅ Menjalankan kode PHP via Tinker (dalam sandbox mode)

Mengapa dibuat? AI modern sangat powerful untuk development, tapi memberikan akses terminal langsung ke AI sangat berbahaya. Server ini memberikan controlled access dengan 10 lapis security layer yang dirancang khusus untuk mencegah kerusakan pada proyek Laravel kamu.

---

✨ Features

🔧 7 Powerful Tools

Tool	Fungsi	Access Level
run_artisan	Jalankan perintah artisan yang aman	🟢 Always Active
read_logs	Baca Laravel logs dengan filter	🟢 Always Active
list_routes	Lihat semua routes dengan filter	🟢 Always Active
read_env	Lihat .env dengan credential masking	🟡 Masked by Default
read_file	Baca source code proyek	🟢 Always Active
write_file	Tulis/edit file proyek	🔴 Requires --allow-write
run_tinker	Jalankan PHP code via Tinker	🔴 Requires --allow-tinker

📂 3 Laravel Resources

• laravel://env — Static view of .env dengan credential masking
• laravel://routes — JSON view lengkap semua routes
• laravel://config/{key} — Dynamic config reader (contoh: laravel://config/app.name)

💬 3 Smart Prompts

• debug-error — Otomatis baca logs dan minta AI menganalisis error
• create-crud — Template untuk generate CRUD lengkap (Model, Migration, Controller, Routes)
• review-code — Code review dengan fokus Laravel best practices

🛡️ 10-Layer Security System

1. Environment Gate — Menolak start jika APP_ENV=production
2. Rate Limiter — Max 30 perintah/menit, 500 perintah/jam
3. Command Classifier — 3-tier risk classification (READ_ONLY, CAUTIOUS, DANGEROUS)
4. Input Sanitizer — Blokir shell injection (;, &&, $(), backticks, dll)
5. Flag Validator — Blokir --force, --seed, --drop-*, --wipe
6. Path Protector — Blokir path traversal (../, syml