""" ----------------------------------------------------------------------------------------- INTERSEL - 4 cité d'Hauteville - 75010 PARIS RCS PARIS 488 379 660 - NAF 721Z File : mcp/response_formatter.py Object : Response formatter for the MCP server ----------------------------------------------------------------------------------------- Modifications : - 2026/01/16 - Damien Lugagne-Delpon - V1.0.0- Creation ----------------------------------------------------------------------------------------- @copyright : Intersel 2026 @author : Damien Lugagne-Delpon - damien.lugagne-delpon@livinweb.fr @version : 1.0.0 (to be updated to the current_version of the developed software if file is touched) ----------------------------------------------------------------------------------------- """ """ Formateur de réponses pour le serveur MCP. Transforme les réponses des outils au format attendu par le protocole MCP. """ import logging import json from typing import Dict, Any, Union, List logger = logging.getLogger(__name__) class ResponseFormatter: """Formateur de réponses MCP.""" @staticmethod def format_tool_response(tool_response: Dict[str, Any]) -> Dict[str, Any]: """ Formater la réponse d'un outil au format MCP. Args: tool_response: Réponse brute de l'outil Returns: Réponse formatée pour MCP """ # Valider que la réponse a la structure attendue if not isinstance(tool_response, dict): return { "success": False, "code": 500, "data": [], "message": "Invalid tool response format" } # Assurer que les champs obligatoires sont présents formatted = { "success": tool_response.get("success", False), "code": tool_response.get("code", 500), "data": tool_response.get("data", []), "message": tool_response.get("message", "No message provided") } # Valider les types if not isinstance(formatted["success"], bool): formatted["success"] = bool(formatted["success"]) if not isinstance(formatted["code"], int): try: formatted["code"] = int(formatted["code"]) except (ValueError, TypeError): formatted["code"] = 500 if not isinstance(formatted["data"], list): formatted["data"] = [formatted["data"]] if not isinstance(formatted["message"], str): formatted["message"] = str(formatted["message"]) return formatted @staticmethod def format_error_response(error_code: int, error_message: str, details: Dict[str, Any] = None) -> Dict[str, Any]: """ Formater une réponse d'erreur. Args: error_code: Code d'erreur HTTP error_message: Message d'erreur details: Détails additionnels de l'erreur Returns: Réponse formatée d'erreur """ return { "success": False, "code": error_code, "data": [details] if details else [], "message": error_message } @staticmethod def format_success_response(data: Union[Dict, List], message: str = "Success") -> Dict[str, Any]: """ Formater une réponse de succès. Args: data: Données de succès message: Message de succès Returns: Réponse formatée de succès """ if isinstance(data, dict): data = [data] elif not isinstance(data, list): data = [data] return { "success": True, "code": 200, "data": data, "message": message } @staticmethod def format_validation_error(field: str, reason: str) -> Dict[str, Any]: """ Formater une erreur de validation. Args: field: Champ en erreur reason: Raison de l'erreur Returns: Réponse formatée d'erreur de validation """ return { "success": False, "code": 400, "data": [{"field": field, "reason": reason}], "message": f"Validation error: {reason}" }