| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181 |
- """
- Outil pour créer une ressource MODX.
- """
- import logging
- from typing import Dict, Any
- import asyncio
- from mcp_server.tools.tool_class import Tool, ToolParameter
- 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": ToolParameter(
- required=True,
- type="string",
- description="Page title of the resource"
- ),
- "template": ToolParameter(
- required=True,
- type="integer",
- description="Template ID to use for the resource"
- ),
- "content": ToolParameter(
- required=False,
- type="string",
- description="Main content of the resource",
- default=""
- ),
- "parent": ToolParameter(
- required=False,
- type="integer",
- description="Parent resource ID (0 for root)",
- default=0
- ),
- "published": ToolParameter(
- required=False,
- type="boolean",
- description="Publish the resource",
- default=False
- ),
- "tvs": ToolParameter(
- required=False,
- type="object",
- description="Template variable values as {tv_name: value}",
- default={}
- ),
- "alias": ToolParameter(
- 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()
|