""" ----------------------------------------------------------------------------------------- INTERSEL - 4 cité d'Hauteville - 75010 PARIS RCS PARIS 488 379 660 - NAF 721Z File : tools/resource/create_resource.py Object : CreateResource tool for the MCP server ----------------------------------------------------------------------------------------- Modifications : - 2026/01/27 - 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) ----------------------------------------------------------------------------------------- """ import logging from typing import Dict, Any import asyncio from mcp_server.tools.tool_class import Tool from mcp_server.api.modx_client import get_modx_client from mcp_server.config import settings from mcp_server.core.constants import ModxType, actionType from mcp_server.core.permissions import check_permission from mcp_server.core.errors import ( ValidationError, PermissionError, MODXAPIError, InternalError, ) logger = logging.getLogger(__name__) class CreateResourceTool(Tool): """Outil pour créer une ressource MODX.""" def __init__(self): """Initialiser l'outil CreateResource.""" super().__init__( name="create_resource", description="Create a new resource in MODX with specified template and properties.", remarks="The template must be available in the context with read permission. " "Use get_template to understand template structure before creation.", parameters={ "pagetitle": { "required":True, "type":"string", "description":"Page title of the resource" }, "template": { "required":True, "type":"integer", "description":"Template ID to use for the resource" }, "content": { "required":False, "type":"string", "description":"Main content of the resource", "default":"" }, "parent": { "required":False, "type":"integer", "description":"Parent resource ID (0 for root)", "default":0 }, "published": { "required":False, "type":"boolean", "description":"Publish the resource", "default":False }, "tvs": { "required":False, "type":"object", "description":"Template variable values as {tv_name: value}", "default":{} }, "alias": { "required":False, "type":"string", "description":"URL alias for the resource", "default":"" }, } ) async def handler(self, **kwargs) -> Dict[str, Any]: """ Créer une ressource MODX. Returns: Dict avec structure {success, code, data, message} """ try: # Extraire les paramètres pagetitle = kwargs.get("pagetitle") template_id = kwargs.get("template") content = kwargs.get("content", "") parent = kwargs.get("parent", 0) published = kwargs.get("published", False) tvs = kwargs.get("tvs", {}) alias = kwargs.get("alias", "") # Validation basique if not pagetitle or not isinstance(pagetitle, str): return { "success": False, "code": 400, "data": [], "message": "pagetitle is required and must be a string" } if not isinstance(template_id, int) or template_id <= 0: return { "success": False, "code": 400, "data": [], "message": "template must be a positive integer" } # Préparer les données pour l'API resource_data = { "pagetitle": pagetitle, "template": template_id, "content": content, "parent": parent, "published": published, } if alias: resource_data["alias"] = alias if tvs: resource_data["tvs"] = tvs # Appeler l'API MODX logger.info(f"Creating resource: {pagetitle}") client = get_modx_client() endpoint = settings.MODX_ENDPOINTS["resource"]["create"] response = client.post(endpoint, resource_data) # Ajouter la ressource créée au contexte if response.get("success") and "data" in response: created_resource = response["data"] if isinstance(created_resource, dict) and "id" in created_resource: # La ressource est créée avec droits read et update # Cela sera géré par le client MCP/l'agent logger.info(f"Resource created successfully: ID {created_resource['id']}") return { "success": response.get("success", False), "code": response.get("code", 500), "data": response.get("data", []), "message": response.get("message", "Resource creation completed") } except PermissionError as e: logger.warning(f"Permission denied: {e.message}") return { "success": False, "code": e.code, "data": [], "message": e.message } except MODXAPIError as e: logger.error(f"MODX API error: {e.message}") return { "success": False, "code": e.code, "data": [], "message": e.message } except ValidationError as e: logger.error(f"Validation error: {e.message}") return { "success": False, "code": e.code, "data": [], "message": e.message } except Exception as e: logger.error(f"Unexpected error in create_resource: {str(e)}") return { "success": False, "code": 500, "data": [], "message": f"Internal error: {str(e)}" } # Instance globale de l'outil create_resource_tool = CreateResourceTool()