create_resource.py 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181
  1. """
  2. Outil pour créer 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.constants import ModxType, actionType
  11. from mcp_server.core.permissions import check_permission
  12. from mcp_server.core.errors import (
  13. ValidationError,
  14. PermissionError,
  15. MODXAPIError,
  16. InternalError,
  17. )
  18. logger = logging.getLogger(__name__)
  19. class CreateResourceTool(Tool):
  20. """Outil pour créer une ressource MODX."""
  21. def __init__(self):
  22. """Initialiser l'outil CreateResource."""
  23. super().__init__(
  24. name="create_resource",
  25. description="Create a new resource in MODX with specified template and properties.",
  26. remarks="The template must be available in the context with read permission. "
  27. "Use get_template to understand template structure before creation.",
  28. parameters={
  29. "pagetitle": ToolParameter(
  30. required=True,
  31. type="string",
  32. description="Page title of the resource"
  33. ),
  34. "template": ToolParameter(
  35. required=True,
  36. type="integer",
  37. description="Template ID to use for the resource"
  38. ),
  39. "content": ToolParameter(
  40. required=False,
  41. type="string",
  42. description="Main content of the resource",
  43. default=""
  44. ),
  45. "parent": ToolParameter(
  46. required=False,
  47. type="integer",
  48. description="Parent resource ID (0 for root)",
  49. default=0
  50. ),
  51. "published": ToolParameter(
  52. required=False,
  53. type="boolean",
  54. description="Publish the resource",
  55. default=False
  56. ),
  57. "tvs": ToolParameter(
  58. required=False,
  59. type="object",
  60. description="Template variable values as {tv_name: value}",
  61. default={}
  62. ),
  63. "alias": ToolParameter(
  64. required=False,
  65. type="string",
  66. description="URL alias for the resource",
  67. default=""
  68. ),
  69. }
  70. )
  71. async def handler(self, **kwargs) -> Dict[str, Any]:
  72. """
  73. Créer une ressource MODX.
  74. Returns:
  75. Dict avec structure {success, code, data, message}
  76. """
  77. try:
  78. # Extraire les paramètres
  79. pagetitle = kwargs.get("pagetitle")
  80. template_id = kwargs.get("template")
  81. content = kwargs.get("content", "")
  82. parent = kwargs.get("parent", 0)
  83. published = kwargs.get("published", False)
  84. tvs = kwargs.get("tvs", {})
  85. alias = kwargs.get("alias", "")
  86. # Validation basique
  87. if not pagetitle or not isinstance(pagetitle, str):
  88. return {
  89. "success": False,
  90. "code": 400,
  91. "data": [],
  92. "message": "pagetitle is required and must be a string"
  93. }
  94. if not isinstance(template_id, int) or template_id <= 0:
  95. return {
  96. "success": False,
  97. "code": 400,
  98. "data": [],
  99. "message": "template must be a positive integer"
  100. }
  101. # Préparer les données pour l'API
  102. resource_data = {
  103. "pagetitle": pagetitle,
  104. "template": template_id,
  105. "content": content,
  106. "parent": parent,
  107. "published": published,
  108. }
  109. if alias:
  110. resource_data["alias"] = alias
  111. if tvs:
  112. resource_data["tvs"] = tvs
  113. # Appeler l'API MODX
  114. logger.info(f"Creating resource: {pagetitle}")
  115. client = get_modx_client()
  116. endpoint = settings.MODX_ENDPOINTS["resource"]["create"]
  117. response = client.post(endpoint, resource_data)
  118. # Ajouter la ressource créée au contexte
  119. if response.get("success") and "data" in response:
  120. created_resource = response["data"]
  121. if isinstance(created_resource, dict) and "id" in created_resource:
  122. # La ressource est créée avec droits read et update
  123. # Cela sera géré par le client MCP/l'agent
  124. logger.info(f"Resource created successfully: ID {created_resource['id']}")
  125. return {
  126. "success": response.get("success", False),
  127. "code": response.get("code", 500),
  128. "data": response.get("data", []),
  129. "message": response.get("message", "Resource creation completed")
  130. }
  131. except PermissionError as e:
  132. logger.warning(f"Permission denied: {e.message}")
  133. return {
  134. "success": False,
  135. "code": e.code,
  136. "data": [],
  137. "message": e.message
  138. }
  139. except MODXAPIError as e:
  140. logger.error(f"MODX API error: {e.message}")
  141. return {
  142. "success": False,
  143. "code": e.code,
  144. "data": [],
  145. "message": e.message
  146. }
  147. except ValidationError as e:
  148. logger.error(f"Validation error: {e.message}")
  149. return {
  150. "success": False,
  151. "code": e.code,
  152. "data": [],
  153. "message": e.message
  154. }
  155. except Exception as e:
  156. logger.error(f"Unexpected error in create_resource: {str(e)}")
  157. return {
  158. "success": False,
  159. "code": 500,
  160. "data": [],
  161. "message": f"Internal error: {str(e)}"
  162. }
  163. # Instance globale de l'outil
  164. create_resource_tool = CreateResourceTool()