| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141 |
- """
- -----------------------------------------------------------------------------------------
- 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}"
- }
|