update_resource.py 5.3 KB

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