update_resource.py 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174
  1. """
  2. -----------------------------------------------------------------------------------------
  3. INTERSEL - 4 cité d'Hauteville - 75010 PARIS
  4. RCS PARIS 488 379 660 - NAF 721Z
  5. File : tools/resource/update_resource.py
  6. Object : UpdateResource tool for the MCP server
  7. -----------------------------------------------------------------------------------------
  8. Modifications :
  9. - 2026/01/27 - 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. import logging
  17. from typing import Dict, Any
  18. import asyncio
  19. from mcp_server.tools.tool_class import Tool
  20. from mcp_server.api.modx_client import get_modx_client
  21. from mcp_server.config import settings
  22. from mcp_server.core.errors import (
  23. ResourceNotFoundError,
  24. MODXAPIError,
  25. ValidationError,
  26. InternalError,
  27. )
  28. logger = logging.getLogger(__name__)
  29. class UpdateResourceTool(Tool):
  30. """Outil pour mettre à jour une ressource MODX."""
  31. def __init__(self):
  32. """Initialiser l'outil UpdateResource."""
  33. super().__init__(
  34. name="update_resource",
  35. description="Update an existing resource in MODX.",
  36. remarks="The resource must be available in the context with update permission. "
  37. "Only provided fields will be updated; omitted fields remain unchanged.",
  38. parameters={
  39. "id": {
  40. "required":True,
  41. "type":"integer",
  42. "description":"ID of the resource to update"
  43. },
  44. "pagetitle": {
  45. "required":False,
  46. "type":"string",
  47. "description":"New page title",
  48. "default":None
  49. },
  50. "content": {
  51. "required":False,
  52. "type":"string",
  53. "description":"New content",
  54. "default":None
  55. },
  56. "published": {
  57. "required":False,
  58. "type":"boolean",
  59. "description":"Publication status",
  60. "default":None
  61. },
  62. "tvs": {
  63. "required":False,
  64. "type":"object",
  65. "description":"Updated template variable values as {tv_name: value}",
  66. "default":{}
  67. },
  68. "alias": {
  69. "required":False,
  70. "type":"string",
  71. "description":"New URL alias",
  72. "default":None
  73. },
  74. }
  75. )
  76. async def handler(self, **kwargs) -> Dict[str, Any]:
  77. """
  78. Mettre à jour une ressource MODX.
  79. Returns:
  80. Dict avec structure {success, code, data, message}
  81. """
  82. try:
  83. # Extraire les paramètres
  84. resource_id = kwargs.get("id")
  85. # Validation basique
  86. if not isinstance(resource_id, int) or resource_id <= 0:
  87. return {
  88. "success": False,
  89. "code": 400,
  90. "data": [],
  91. "message": "id must be a positive integer"
  92. }
  93. # Préparer les données à mettre à jour (seulement les champs fournis)
  94. resource_data = {"id": resource_id}
  95. # Ajouter les champs optionnels s'ils sont fournis
  96. if kwargs.get("pagetitle") is not None:
  97. resource_data["pagetitle"] = kwargs.get("pagetitle")
  98. if kwargs.get("content") is not None:
  99. resource_data["content"] = kwargs.get("content")
  100. if kwargs.get("published") is not None:
  101. resource_data["published"] = kwargs.get("published")
  102. if kwargs.get("alias") is not None:
  103. resource_data["alias"] = kwargs.get("alias")
  104. tvs = kwargs.get("tvs", {})
  105. if tvs:
  106. resource_data["tvs"] = tvs
  107. # Vérifier qu'au moins un champ est à mettre à jour
  108. if len(resource_data) == 1: # Seulement l'id
  109. return {
  110. "success": False,
  111. "code": 400,
  112. "data": [],
  113. "message": "At least one field must be provided for update"
  114. }
  115. # Appeler l'API MODX
  116. logger.info(f"Updating resource: ID {resource_id}")
  117. client = get_modx_client()
  118. endpoint = settings.MODX_ENDPOINTS["resource"]["update"].format(id=resource_id)
  119. response = client.put(endpoint, resource_data)
  120. return {
  121. "success": response.get("success", False),
  122. "code": response.get("code", 500),
  123. "data": response.get("data", []),
  124. "message": response.get("message", "Resource update completed")
  125. }
  126. except MODXAPIError as e:
  127. logger.error(f"MODX API error: {e.message}")
  128. return {
  129. "success": False,
  130. "code": e.code,
  131. "data": [],
  132. "message": e.message
  133. }
  134. except ValidationError as e:
  135. logger.error(f"Validation error: {e.message}")
  136. return {
  137. "success": False,
  138. "code": e.code,
  139. "data": [],
  140. "message": e.message
  141. }
  142. except Exception as e:
  143. logger.error(f"Unexpected error in update_resource: {str(e)}")
  144. return {
  145. "success": False,
  146. "code": 500,
  147. "data": [],
  148. "message": f"Internal error: {str(e)}"
  149. }
  150. # Instance globale de l'outil
  151. update_resource_tool = UpdateResourceTool()