Update README files to warn against using artisan serve with MCP SSE

Author: kargnas

README.ko.md

@@ -135,7 +135,25 @@ npx @modelcontextprotocol/inspector node build/index.js
 
 이 명령어는 보통 `localhost:6274`에 웹 인터페이스를 띄워줍니다. MCP 서버 테스트 방법:
 
-1. Laravel 개발 서버를 시작합니다(예: `php artisan serve`)
+1. **주의사항**: `php artisan serve`는 여러 개의 PHP 커넥션을 동시에 처리할 수 없기 때문에 이 패키지에서 사용할 수 없습니다. MCP SSE는 여러 커넥션을 동시에 처리해야 하므로 다음 대안 중 하나를 반드시 사용해야 합니다:
+
+   * **Laravel Octane** (가장 쉬운 방법):
+     ```bash
+     # Laravel Octane 설치 및 설정
+     composer require laravel/octane
+     php artisan octane:install
+     
+     # Octane 서버 시작
+     php artisan octane:start
+     ```
+     자세한 내용은 [Laravel Octane 문서](https://laravel.com/docs/12.x/octane)를 참고하세요.
+     
+   * **프로덕션급 옵션**:
+     - Nginx + PHP-FPM
+     - Apache + PHP-FPM
+     - 커스텀 Docker 설정
+     - SSE 스트리밍을 제대로 지원하는 모든 웹 서버
+
 2. 인스펙터 인터페이스에서 Laravel 서버의 MCP SSE URL을 입력합니다(예: `http://localhost:8000/mcp/sse`)
 3. 연결하고 사용 가능한 도구를 시각적으로 탐색합니다
 

README.md

@@ -135,7 +135,24 @@ npx @modelcontextprotocol/inspector node build/index.js
 
 This will typically open a web interface at `localhost:6274`. To test your MCP server:
 
-1. Start your Laravel development server (e.g., `php artisan serve`)  
+1. **Warning**: `php artisan serve` CANNOT be used with this package because it cannot handle multiple PHP connections simultaneously. Since MCP SSE requires processing multiple connections concurrently, you must use one of these alternatives:
+
+   * **Laravel Octane** (Easiest option):
+     ```bash
+     # Install and set up Laravel Octane
+     composer require laravel/octane
+     php artisan octane:install
+     
+     # Start the Octane server
+     php artisan octane:start
+     ```
+     For details, see the [Laravel Octane documentation](https://laravel.com/docs/12.x/octane)
+     
+   * **Production-grade options**:
+     - Nginx + PHP-FPM
+     - Apache + PHP-FPM
+     - Custom Docker setup
+     - Any web server that properly supports SSE streaming  
 2. In the Inspector interface, enter your Laravel server's MCP SSE URL (e.g., `http://localhost:8000/mcp/sse`)  
 3. Connect and explore available tools visually
 

README.pl.md

@@ -135,7 +135,25 @@ npx @modelcontextprotocol/inspector node build/index.js
 
 To otworzy interfejs w przeglądarce na `localhost:6274`. Żeby przetestować swój serwer:
 
-1. Uruchom Laravel (`php artisan serve`)
+1. **UWAGA**: NIE MOŻNA używać `php artisan serve` z tym pakietem, ponieważ nie może on obsługiwać wielu połączeń PHP jednocześnie. Ponieważ MCP SSE wymaga przetwarzania wielu połączeń równocześnie, należy użyć jednej z tych alternatyw:
+
+   * **Laravel Octane** (najłatwiejsza opcja):
+     ```bash
+     # Instalacja i konfiguracja Laravel Octane
+     composer require laravel/octane
+     php artisan octane:install
+     
+     # Uruchom serwer Octane
+     php artisan octane:start
+     ```
+     Szczegóły znajdziesz w [dokumentacji Laravel Octane](https://laravel.com/docs/12.x/octane)
+     
+   * **Opcje produkcyjne**:
+     - Nginx + PHP-FPM
+     - Apache + PHP-FPM
+     - Własna konfiguracja Docker
+     - Dowolny serwer internetowy z prawidłową obsługą streamingu SSE
+
 2. W Inspektorze wklej URL swojego serwera SSE (np. `http://localhost:8000/mcp/sse`)
 3. Połącz się i testuj narzędzia wizualnie
 

README.pt-BR.md

@@ -135,7 +135,25 @@ npx @modelcontextprotocol/inspector node build/index.js
 
 Isso vai abrir uma interface web em `localhost:6274`. Pra testar seu servidor MCP:
 
-1. Inicie seu servidor Laravel (`php artisan serve`)
+1. **ATENÇÃO**: NÃO É POSSÍVEL usar `php artisan serve` com este pacote porque ele não consegue processar múltiplas conexões PHP simultaneamente. Como o MCP SSE precisa processar várias conexões ao mesmo tempo, você deve usar uma destas alternativas:
+
+   * **Laravel Octane** (opção mais fácil):
+     ```bash
+     # Instalar e configurar Laravel Octane
+     composer require laravel/octane
+     php artisan octane:install
+     
+     # Iniciar o servidor Octane
+     php artisan octane:start
+     ```
+     Para detalhes, consulte a [documentação do Laravel Octane](https://laravel.com/docs/12.x/octane)
+     
+   * **Opções para produção**:
+     - Nginx + PHP-FPM
+     - Apache + PHP-FPM
+     - Configuração Docker personalizada
+     - Qualquer servidor web que suporte streaming SSE corretamente
+
 2. No Inspector, coloque a URL SSE do seu servidor (tipo `http://localhost:8000/mcp/sse`)
 3. Conecte e explore as ferramentas visualmente
 

README.ru.md

@@ -135,7 +135,25 @@ npx @modelcontextprotocol/inspector node build/index.js
 
 Это обычно открывает веб-интерфейс на `localhost:6274`. Чтобы протестировать ваш MCP сервер:
 
-1. Запустите сервер разработки Laravel (например, `php artisan serve`)
+1. **ВНИМАНИЕ**: НЕВОЗМОЖНО использовать `php artisan serve` с этим пакетом, поскольку он не может обрабатывать несколько PHP-соединений одновременно. Поскольку MCP SSE требует обработки нескольких соединений одновременно, Вы должны использовать одну из этих альтернатив:
+
+   * **Laravel Octane** (самый простой вариант):
+     ```bash
+     # Установка и настройка Laravel Octane
+     composer require laravel/octane
+     php artisan octane:install
+     
+     # Запуск сервера Octane
+     php artisan octane:start
+     ```
+     Подробности смотрите в [документации Laravel Octane](https://laravel.com/docs/12.x/octane)
+     
+   * **Продакшн-варианты**:
+     - Nginx + PHP-FPM
+     - Apache + PHP-FPM
+     - Собственная настройка Docker
+     - Любой веб-сервер с правильной поддержкой стриминга SSE
+
 2. В интерфейсе Инспектора введите URL SSE вашего Laravel сервера (например, `http://localhost:8000/mcp/sse`)
 3. Подключитесь и исследуйте доступные инструменты визуально
 

README.zh-CN.md

@@ -135,7 +135,25 @@ npx @modelcontextprotocol/inspector node build/index.js
 
 这个命令会在 `localhost:6274` 打开一个可视化界面。要测试你的 MCP 服务器：
 
-1. 跑起你的 Laravel 服务器（比如 `php artisan serve`）
+1. **警告**: 无法使用 `php artisan serve` 运行此包，因为它无法同时处理多个 PHP 连接。由于 MCP SSE 需要同时处理多个连接，你必须使用以下替代方案之一：
+
+   * **Laravel Octane** (最简单选项):
+     ```bash
+     # 安装和设置 Laravel Octane
+     composer require laravel/octane
+     php artisan octane:install
+     
+     # 启动 Octane 服务器
+     php artisan octane:start
+     ```
+     详细信息请参考 [Laravel Octane 文档](https://laravel.com/docs/12.x/octane)
+     
+   * **生产级选项**:
+     - Nginx + PHP-FPM
+     - Apache + PHP-FPM
+     - 自定义 Docker 配置
+     - 任何正确支持 SSE 流式传输的 Web 服务器
+
 2. 在 Inspector 界面中，输入你的 SSE URL（比如 `http://localhost:8000/mcp/sse`）
 3. 连接后就能直观地查看和测试所有工具了
 

README.zh-TW.md

@@ -135,7 +135,25 @@ npx @modelcontextprotocol/inspector node build/index.js
 
 這會在 `localhost:6274` 開一個網頁界面。測試 MCP 伺服器的方法：
 
-1. 先跑起 Laravel 開發伺服器（比如用 `php artisan serve`）
+1. **警告**: 無法使用 `php artisan serve` 執行此套件，因為它無法同時處理多個 PHP 連接。由於 MCP SSE 需要同時處理多個連接，你必須使用以下替代方案之一：
+
+   * **Laravel Octane** (最簡單選項):
+     ```bash
+     # 安裝和設定 Laravel Octane
+     composer require laravel/octane
+     php artisan octane:install
+     
+     # 啟動 Octane 伺服器
+     php artisan octane:start
+     ```
+     詳細資訊請參考 [Laravel Octane 文件](https://laravel.com/docs/12.x/octane)
+     
+   * **生產級選項**:
+     - Nginx + PHP-FPM
+     - Apache + PHP-FPM
+     - 自定義 Docker 配置
+     - 任何正確支援 SSE 串流的 Web 伺服器
+
 2. 在 Inspector 界面輸入你的 SSE URL（比如 `http://localhost:8000/mcp/sse`）
 3. 連上後就能超直覺地查看所有工具了