response_formatter.py 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141
  1. """
  2. -----------------------------------------------------------------------------------------
  3. INTERSEL - 4 cité d'Hauteville - 75010 PARIS
  4. RCS PARIS 488 379 660 - NAF 721Z
  5. File : mcp/response_formatter.py
  6. Object : Response formatter for the MCP server
  7. -----------------------------------------------------------------------------------------
  8. Modifications :
  9. - 2026/01/16 - Damien Lugagne-Delpon - V1.0.0- Creation
  10. -----------------------------------------------------------------------------------------
  11. @copyright : Intersel 2026
  12. @author : Damien Lugagne-Delpon - damien.lugagne-delpon@livinweb.fr
  13. @version : 1.0.0 (to be updated to the current_version of the developed software if file is touched)
  14. -----------------------------------------------------------------------------------------
  15. """
  16. """
  17. Formateur de réponses pour le serveur MCP.
  18. Transforme les réponses des outils au format attendu par le protocole MCP.
  19. """
  20. import logging
  21. import json
  22. from typing import Dict, Any, Union, List
  23. logger = logging.getLogger(__name__)
  24. class ResponseFormatter:
  25. """Formateur de réponses MCP."""
  26. @staticmethod
  27. def format_tool_response(tool_response: Dict[str, Any]) -> Dict[str, Any]:
  28. """
  29. Formater la réponse d'un outil au format MCP.
  30. Args:
  31. tool_response: Réponse brute de l'outil
  32. Returns:
  33. Réponse formatée pour MCP
  34. """
  35. # Valider que la réponse a la structure attendue
  36. if not isinstance(tool_response, dict):
  37. return {
  38. "success": False,
  39. "code": 500,
  40. "data": [],
  41. "message": "Invalid tool response format"
  42. }
  43. # Assurer que les champs obligatoires sont présents
  44. formatted = {
  45. "success": tool_response.get("success", False),
  46. "code": tool_response.get("code", 500),
  47. "data": tool_response.get("data", []),
  48. "message": tool_response.get("message", "No message provided")
  49. }
  50. # Valider les types
  51. if not isinstance(formatted["success"], bool):
  52. formatted["success"] = bool(formatted["success"])
  53. if not isinstance(formatted["code"], int):
  54. try:
  55. formatted["code"] = int(formatted["code"])
  56. except (ValueError, TypeError):
  57. formatted["code"] = 500
  58. if not isinstance(formatted["data"], list):
  59. formatted["data"] = [formatted["data"]]
  60. if not isinstance(formatted["message"], str):
  61. formatted["message"] = str(formatted["message"])
  62. return formatted
  63. @staticmethod
  64. def format_error_response(error_code: int, error_message: str, details: Dict[str, Any] = None) -> Dict[str, Any]:
  65. """
  66. Formater une réponse d'erreur.
  67. Args:
  68. error_code: Code d'erreur HTTP
  69. error_message: Message d'erreur
  70. details: Détails additionnels de l'erreur
  71. Returns:
  72. Réponse formatée d'erreur
  73. """
  74. return {
  75. "success": False,
  76. "code": error_code,
  77. "data": [details] if details else [],
  78. "message": error_message
  79. }
  80. @staticmethod
  81. def format_success_response(data: Union[Dict, List], message: str = "Success") -> Dict[str, Any]:
  82. """
  83. Formater une réponse de succès.
  84. Args:
  85. data: Données de succès
  86. message: Message de succès
  87. Returns:
  88. Réponse formatée de succès
  89. """
  90. if isinstance(data, dict):
  91. data = [data]
  92. elif not isinstance(data, list):
  93. data = [data]
  94. return {
  95. "success": True,
  96. "code": 200,
  97. "data": data,
  98. "message": message
  99. }
  100. @staticmethod
  101. def format_validation_error(field: str, reason: str) -> Dict[str, Any]:
  102. """
  103. Formater une erreur de validation.
  104. Args:
  105. field: Champ en erreur
  106. reason: Raison de l'erreur
  107. Returns:
  108. Réponse formatée d'erreur de validation
  109. """
  110. return {
  111. "success": False,
  112. "code": 400,
  113. "data": [{"field": field, "reason": reason}],
  114. "message": f"Validation error: {reason}"
  115. }