chore: Upgrade php-mcp/server to version ^3.0 and refactor transport handling

- Updated `php-mcp/server` dependency to version `^3.0` in composer.json.
- Refactored HTTP transport handling by removing the old `McpController` and introducing `SseTransportController` and `StreamableTransportController`.
- Enhanced configuration options in `mcp.php` for dedicated and integrated HTTP transports, including support for JSON responses and event stores.
- Updated routing to use a new web.php file for handling transport routes.
- Improved session management and logging configurations in the MCP setup.
- Adjusted command outputs for clarity when starting the MCP server.

Author: CodeWithKyrian

composer.json

@@ -21,7 +21,7 @@
     "require": {
         "php": "^8.1",
         "laravel/framework": "^9.46 || ^10.34 || ^11.29 || ^12.0",
-        "php-mcp/server": "^2.3"
+        "php-mcp/server": "^3.0"
     },
     "require-dev": {
         "laravel/pint": "^1.13",

config/mcp.php

@@ -80,21 +80,43 @@
 
         'http_dedicated' => [
             'enabled' => (bool) env('MCP_HTTP_DEDICATED_ENABLED', true),
+            'legacy' => (bool) env('MCP_HTTP_DEDICATED_LEGACY', false),
             'host' => env('MCP_HTTP_DEDICATED_HOST', '127.0.0.1'),
             'port' => (int) env('MCP_HTTP_DEDICATED_PORT', 8090),
             'path_prefix' => env('MCP_HTTP_DEDICATED_PATH_PREFIX', 'mcp'),
             'ssl_context_options' => [],
+            'enable_json_response' => (bool) env('MCP_HTTP_DEDICATED_JSON_RESPONSE', true),
+            'event_store' => env('MCP_HTTP_DEDICATED_EVENT_STORE'), // FQCN or null
         ],
 
         'http_integrated' => [
             'enabled' => (bool) env('MCP_HTTP_INTEGRATED_ENABLED', true),
+            'legacy' => (bool) env('MCP_HTTP_INTEGRATED_LEGACY', false),
             'route_prefix' => env('MCP_HTTP_INTEGRATED_ROUTE_PREFIX', 'mcp'),
             'middleware' => explode(',', env('MCP_HTTP_INTEGRATED_MIDDLEWARE', 'web')),
             'domain' => env('MCP_HTTP_INTEGRATED_DOMAIN'),
             'sse_poll_interval' => (int) env('MCP_HTTP_INTEGRATED_SSE_POLL_SECONDS', 1),
+            'cors_origin' => env('MCP_HTTP_INTEGRATED_CORS_ORIGIN', '*'),
+            'enable_json_response' => (bool) env('MCP_HTTP_INTEGRATED_JSON_RESPONSE', true),
+            'json_response_timeout' => (int) env('MCP_HTTP_INTEGRATED_JSON_TIMEOUT', 30),
+            'event_store' => env('MCP_HTTP_INTEGRATED_EVENT_STORE'), // FQCN or null
         ],
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Session Management Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configure how the MCP server manages client sessions. Sessions store
+    | client state, message queues, and subscriptions.
+    |
+    */
+    'session' => [
+        'driver' => env('MCP_SESSION_DRIVER', 'cache'), // 'array' or 'cache'
+        'ttl' => (int) env('MCP_SESSION_TTL', 3600), // Session lifetime in seconds
+    ],
+
     /*
     |--------------------------------------------------------------------------
     | Pagination Limit

routes/mcp_http_integrated.php

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use PhpMcp\Laravel\Http\Controllers\StreamableTransportController;
+use PhpMcp\Laravel\Http\Controllers\SseTransportController;
+
+if (config('mcp.transports.http_integrated.legacy', false)) {
+    Route::get('/sse', [SseTransportController::class, 'handleSse'])
+        ->name('mcp.sse');
+
+    Route::post('/message', [SseTransportController::class, 'handleMessage'])
+        ->name('mcp.message');
+} else {
+    Route::get('/', [StreamableTransportController::class, 'handleGet'])
+        ->name('mcp.streamable.get');
+
+    Route::post('/', [StreamableTransportController::class, 'handlePost'])
+        ->name('mcp.streamable.post');
+
+    Route::delete('/', [StreamableTransportController::class, 'handleDelete'])
+        ->name('mcp.streamable.delete');
+}