get_resource.py 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. """
  2. Outil pour lire 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. InternalError,
  14. )
  15. logger = logging.getLogger(__name__)
  16. class GetResourceTool(Tool):
  17. """Outil pour lire une ressource MODX."""
  18. def __init__(self):
  19. """Initialiser l'outil GetResource."""
  20. super().__init__(
  21. name="get_resource",
  22. description="Retrieve a resource from MODX by its ID.",
  23. remarks="The resource must be available in the context with read permission. "
  24. "Returns full resource data including TVs and metadata.",
  25. parameters={
  26. "id": ToolParameter(
  27. required=True,
  28. type="integer",
  29. description="ID of the resource to retrieve"
  30. ),
  31. }
  32. )
  33. async def handler(self, **kwargs) -> Dict[str, Any]:
  34. """
  35. Lire une ressource MODX.
  36. Returns:
  37. Dict avec structure {success, code, data, message}
  38. """
  39. try:
  40. # Extraire les paramètres
  41. resource_id = kwargs.get("id")
  42. # Validation basique
  43. if not isinstance(resource_id, int) or resource_id <= 0:
  44. return {
  45. "success": False,
  46. "code": 400,
  47. "data": [],
  48. "message": "id must be a positive integer"
  49. }
  50. # Appeler l'API MODX
  51. logger.info(f"Retrieving resource: ID {resource_id}")
  52. client = get_modx_client()
  53. endpoint = settings.MODX_ENDPOINTS["resource"]["read"].format(id=resource_id)
  54. response = client.get(endpoint)
  55. return {
  56. "success": response.get("success", False),
  57. "code": response.get("code", 500),
  58. "data": response.get("data", []),
  59. "message": response.get("message", "Resource retrieval completed")
  60. }
  61. except MODXAPIError as e:
  62. logger.error(f"MODX API error: {e.message}")
  63. return {
  64. "success": False,
  65. "code": e.code,
  66. "data": [],
  67. "message": e.message
  68. }
  69. except Exception as e:
  70. logger.error(f"Unexpected error in get_resource: {str(e)}")
  71. return {
  72. "success": False,
  73. "code": 500,
  74. "data": [],
  75. "message": f"Internal error: {str(e)}"
  76. }
  77. # Instance globale de l'outil
  78. # get_resource_tool = GetResourceTool()
  79. # """Handler function to get the resource."""
  80. # pass