Jelajahi Sumber

update server MCP with tools and resources for website configuration

Khanh Nguyen 5 bulan lalu
induk
melakukan
3b154a5f05
3 mengubah file dengan 190 tambahan dan 0 penghapusan
  1. 70 0
      src/server_mcp/resources_config.py
  2. 4 0
      src/server_mcp/server.py
  3. 116 0
      src/server_mcp/tools_config.py

+ 70 - 0
src/server_mcp/resources_config.py

@@ -0,0 +1,70 @@
+"""Definition des ressources MCP (lecture ClientConfig)."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from ..services.client_rest import ClientRest, HTTPMethod
+
+
+def _unwrap_data(response: Any) -> Any:
+    """Extrait le payload utile des reponses LWE {code,message,data}."""
+    if isinstance(response, dict) and "data" in response:
+        return response["data"]
+    return response
+
+
+def register_config_resources(mcp_server: Any, client_rest: ClientRest) -> None:
+    """Enregistre les ressources de lecture ClientConfig du serveur MCP."""
+
+    @mcp_server.resource(
+        "modx://clientconfig/settings",
+        mime_type="application/json",
+        description="Liste toutes les configurations du site.",
+    )
+    def get_configs() -> dict[str, Any]:
+        response = client_rest.execute(
+            method=HTTPMethod.GET,
+            endpoint="/rest/clientconfig/settings",
+        )
+        data = _unwrap_data(response)
+        return {"items": data} if isinstance(data, list) else {"data": data}
+
+    @mcp_server.resource(
+        "modx://clientconfig/setting/{id}",
+        mime_type="application/json",
+        description="Liste les informations d'une configuration du site.",
+    )
+    def get_config(id: str) -> dict[str, Any]:
+        response = client_rest.execute(
+            method=HTTPMethod.GET,
+            endpoint=f"/rest/clientconfig/setting/{id}",
+        )
+        data = _unwrap_data(response)
+        return data if isinstance(data, dict) else {"data": data}
+
+    @mcp_server.resource(
+        "modx://clientconfig/groups",
+        mime_type="application/json",
+        description="Liste toutes les groupes de configurations du site.",
+    )
+    def get_config_groups() -> dict[str, Any]:
+        response = client_rest.execute(
+            method=HTTPMethod.GET,
+            endpoint="/rest/clientconfig/groups",
+        )
+        data = _unwrap_data(response)
+        return {"items": data} if isinstance(data, list) else {"data": data}
+
+    @mcp_server.resource(
+        "modx://clientconfig/group/{id}",
+        mime_type="application/json",
+        description="Liste toutes les configurations d'un groupe du site.",
+    )
+    def get_config_group(id: str) -> dict[str, Any]:
+        response = client_rest.execute(
+            method=HTTPMethod.GET,
+            endpoint=f"/rest/clientconfig/group/{id}",
+        )
+        data = _unwrap_data(response)
+        return {"items": data} if isinstance(data, list) else {"data": data}

+ 4 - 0
src/server_mcp/server.py

@@ -4,8 +4,10 @@ from __future__ import annotations
 
 from mcp.server.fastmcp import FastMCP
 
+from .resources_config import register_config_resources
 from .resources_element import register_element_resources
 from .resources_groupmgt import register_groupmgt_resources
+from .tools_config import register_config_tools
 from .tools_groupmgt import register_groupmgt_tools
 from .tools_element import register_element_tools
 from src.services.client_rest import ClientRest
@@ -16,6 +18,8 @@ def build_server(client_rest: ClientRest) -> FastMCP:
     server = FastMCP("lw-copilot-mcp-server")
     register_element_tools(server, client_rest)
     register_groupmgt_tools(server, client_rest)
+    register_config_tools(server, client_rest)
     register_element_resources(server, client_rest)
     register_groupmgt_resources(server, client_rest)
+    register_config_resources(server, client_rest)
     return server

+ 116 - 0
src/server_mcp/tools_config.py

@@ -0,0 +1,116 @@
+"""Definition des outils MCP (operations ClientConfig)."""
+
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from pydantic import Field
+
+from mcp.types import ToolAnnotations
+
+from ..services.client_rest import ClientRest, HTTPMethod
+
+_WRITE_IDEMPOTENT = ToolAnnotations(
+    readOnlyHint=False, destructiveHint=True, idempotentHint=True
+)
+
+# --- createConfig ---
+ConfigKey = Annotated[str, Field(description="unique setting key")]
+ConfigLabel = Annotated[str, Field(description="display label")]
+ConfigValueOpt = Annotated[str | None, Field(default=None, description="initial setting value")]
+Xtype = Annotated[str | None, Field(default=None, description="field rendering type")]
+ConfigDescription = Annotated[str | None, Field(default=None, description="setting description")]
+IsRequired = Annotated[bool | None, Field(default=None, description="whether the setting is required")]
+SortOrder = Annotated[int | None, Field(default=None, description="display order")]
+ConfigDefault = Annotated[str | None, Field(default=None, description="default value")]
+ConfigGroup = Annotated[int | None, Field(default=None, description="ClientConfig group id")]
+Options = Annotated[str | None, Field(default=None, description="field options")]
+ProcessOptions = Annotated[bool | None, Field(default=None, description="whether options are processed")]
+Source = Annotated[int | None, Field(default=None, description="media source id")]
+
+# --- updateConfig ---
+ConfigId = Annotated[int | str, Field(description="configuration id")]
+ConfigValue = Annotated[str, Field(description="configuration value")]
+
+# --- createConfigGroup ---
+GroupLabel = Annotated[str, Field(description="group label")]
+GroupDescription = Annotated[str | None, Field(default=None, description="group description")]
+GroupSortOrder = Annotated[int | None, Field(default=None, description="display order")]
+
+
+def _omit_none(**kwargs: Any) -> dict[str, Any]:
+    return {key: value for key, value in kwargs.items() if value is not None}
+
+
+def register_config_tools(mcp_server: Any, client_rest: ClientRest) -> None:
+    """Enregistre les outils ClientConfig du serveur MCP."""
+
+    @mcp_server.tool(
+        description="Creer une configuration du site.",
+        annotations=_WRITE_IDEMPOTENT,
+    )
+    def createConfig(
+        key: ConfigKey,
+        label: ConfigLabel,
+        value: ConfigValueOpt = None,
+        xtype: Xtype = None,
+        description: ConfigDescription = None,
+        isRequired: IsRequired = None,
+        sortOrder: SortOrder = None,
+        default: ConfigDefault = None,
+        group: ConfigGroup = None,
+        options: Options = None,
+        processOptions: ProcessOptions = None,
+        source: Source = None,
+    ) -> dict[str, Any]:
+        return client_rest.execute(
+            method=HTTPMethod.POST,
+            endpoint="/rest/clientconfig/setting",
+            json=_omit_none(
+                key=key,
+                label=label,
+                value=value,
+                xtype=xtype,
+                description=description,
+                isRequired=isRequired,
+                sortOrder=sortOrder,
+                default=default,
+                group=group,
+                options=options,
+                processOptions=processOptions,
+                source=source,
+            ),
+        )
+
+    @mcp_server.tool(
+        description="Mettre a jour une configuration du site.",
+        annotations=_WRITE_IDEMPOTENT,
+    )
+    def updateConfig(
+        id: ConfigId,
+        value: ConfigValue,
+    ) -> dict[str, Any]:
+        return client_rest.execute(
+            method=HTTPMethod.PUT,
+            endpoint="/rest/clientconfig/setting",
+            json={"id": id, "value": value},
+        )
+
+    @mcp_server.tool(
+        description="Creer un groupe de configuration du site.",
+        annotations=_WRITE_IDEMPOTENT,
+    )
+    def createConfigGroup(
+        label: GroupLabel,
+        description: GroupDescription = None,
+        sortOrder: GroupSortOrder = None,
+    ) -> dict[str, Any]:
+        return client_rest.execute(
+            method=HTTPMethod.POST,
+            endpoint="/rest/clientconfig/group",
+            json=_omit_none(
+                label=label,
+                description=description,
+                sortOrder=sortOrder,
+            ),
+        )