Add PHPDoc comments and minor concatenation fix

Added PHPDoc comments to improve code documentation and clarify method purposes and parameter types across routing and protocol files. Also fixed a minor string concatenation issue for error handling in `MCPProtocol`. These changes enhance code readability and maintainability.

Author: klapaudius

src/Protocol/MCPProtocol.php

@@ -47,6 +47,12 @@ public function __construct(TransportInterface $transport)
     }
 
     /**
+     * Establishes a connection and processes incoming messages from the transport layer.
+     *
+     * The method starts the transport, continuously checks for incoming messages while connected,
+     * handles each message appropriately, and disconnects when the connection ends.
+     *
+     * @return void
      * @throws Exception
      */
     public function connect(): void
@@ -68,26 +74,58 @@ public function connect(): void
         $this->disconnect();
     }
 
+    /**
+     * Sends a message using the configured transport.
+     *
+     * @param string|array $message The message to be sent, either as a string or an array.
+     * @return void
+     */
     public function send(string|array $message): void
     {
         $this->transport->send(message: $message);
     }
 
+    /**
+     * Disconnects the current transport by closing the connection.
+     *
+     * @return void
+     */
     public function disconnect(): void
     {
         $this->transport->close();
     }
 
+    /**
+     * Registers a request handler to manage incoming requests.
+     *
+     * @param RequestHandler $handler The request handler instance to be registered.
+     * @return void
+     */
     public function registerRequestHandler(RequestHandler $handler): void
     {
         $this->requestHandlers[] = $handler;
     }
 
+    /**
+     * Registers a notification handler to handle incoming notifications.
+     *
+     * @param NotificationHandler $handler The notification handler instance to be registered.
+     * @return void
+     */
     public function registerNotificationHandler(NotificationHandler $handler): void
     {
         $this->notificationHandlers[] = $handler;
     }
 
+    /**
+     * Handles an incoming JSON-RPC message from a client, processes it as either a request or notification,
+     * and manages error responses when necessary.
+     *
+     * @param string $clientId The unique identifier for the client sending the message
+     * @param array $message The JSON-RPC message data to process
+     * @return void
+     * @throws JsonRpcErrorException
+     */
     public function handleMessage(string $clientId, array $message): void
     {
         $messageId = $message['id'] ?? null;
@@ -143,7 +181,7 @@ private function handleRequestProcess(string $clientId, RequestData $requestData
         } catch (JsonRpcErrorException $e) {
             $this->pushMessage(clientId: $clientId, message: new JsonRpcErrorResource(exception: $e, id: $messageId));
         } catch (ToolParamsValidatorException $e) {
-            $jsonRpcErrorException = new JsonRpcErrorException(message: $e->getMessage().implode(',', $e->getErrors()), code: JsonRpcErrorCode::INVALID_PARAMS);
+            $jsonRpcErrorException = new JsonRpcErrorException(message: $e->getMessage() . ' ' . implode(',', $e->getErrors()), code: JsonRpcErrorCode::INVALID_PARAMS);
             $this->pushMessage(clientId: $clientId, message: new JsonRpcErrorResource(exception: $jsonRpcErrorException, id: $messageId));
         } catch (Exception $e) {
             $jsonRpcErrorException = new JsonRpcErrorException(message: $e->getMessage(), code: JsonRpcErrorCode::INTERNAL_ERROR);

src/Resources/config/routes.php

@@ -4,6 +4,12 @@
 use KLP\KlpMcpServer\Controllers\SseController;
 use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
+/**
+ * Configures routes for the application.
+ *
+ * @param RoutingConfigurator $routes The routing configurator used to define routes.
+ * @return void
+ */
 return function (RoutingConfigurator $routes) {
     $routes->add('sse_route', '/mcp/sse')
         ->controller([SseController::class, 'handle'])