ncloud-mcp-server 1.0.4 → 1.1.1

package/dist/tools/cloud-insight-plugin.js

@@ -1,596 +1,534 @@
 import { z } from "zod";
+import { toolText } from "./_response.js";
+// Cloud Insight Plugin / Custom Resource / Schema / Planned Maintenance APIs
+// Base: https://cw.apigw.ntruss.com. 경로/메서드/필드는 공식 docs(management-cloudinsight-*) 기준.
+//   - Plugin(process/port/file):  prefix /cw_server/real/api/plugin/...
+//   - Custom Resource / Schema / Planned Maintenance:  prefix /cw_fea/real/cw/api/...
+const CW_SERVER = "/cw_server/real/api/plugin";
+const CW = "/cw_fea/real/cw/api";
+const targetType = z
+    .enum(["vpcserver", "classicserver", "cloudhadoop"])
+    .optional()
+    .describe("Target type (default 'vpcserver')");
 export function registerCloudInsightPluginTools(server, client) {
-    // --- Plugin Tools ---
-    // ncloud_list_process_plugins — Get process plugin list
-    server.tool("ncloud_list_process_plugins", "Get the list of Cloud Insight process monitoring plugins.", {
-        instanceNo: z.string().optional().describe("Server instance number to filter plugins"),
-    }, async (params) => {
+    // ─── Process plugin ─────────────────────────────────────────────────────
+    server.tool("ncloud_list_process_plugins", "Get the full list of Cloud Insight process monitoring plugins.", {}, async () => {
         try {
-            const body = {};
-            if (params.instanceNo !== undefined)
-                body.instanceNo = params.instanceNo;
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/process", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW_SERVER}/process`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_add_process_plugin — Add a process monitoring plugin
-    server.tool("ncloud_add_process_plugin", "Add a process monitoring plugin to Cloud Insight for monitoring specific processes on a server.", {
-        instanceNo: z.string().describe("Server instance number to add the plugin to"),
-        processName: z.string().describe("Name of the process to monitor"),
-    }, async (params) => {
+    server.tool("ncloud_get_process_plugin", "Get process monitoring plugin configuration for a specific server instance.", { instanceNo: z.string().describe("Server instance number") }, async (params) => {
         try {
-            const body = {
-                instanceNo: params.instanceNo,
-                processName: params.processName,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/process/add", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW_SERVER}/process/instanceNo/${params.instanceNo}`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_remove_process_plugin — Remove a process monitoring plugin
-    server.tool("ncloud_remove_process_plugin", "⚠️ Destructive: Remove a process monitoring plugin from Cloud Insight.", {
+    server.tool("ncloud_add_process_plugin", "Add process monitoring plugin(s) to a server instance. Provide one or more process names (wildcards like *abc* allowed).", {
         instanceNo: z.string().describe("Server instance number"),
-        processName: z.string().describe("Name of the process plugin to remove"),
-        confirm: z.boolean().optional().describe("Must be true to execute deletion. If false or omitted, returns a confirmation prompt."),
+        configList: z.array(z.string()).min(1).describe("Process names to monitor"),
+        type: targetType,
     }, async (params) => {
         try {
-            if (!params.confirm) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `⚠️ This will permanently remove process plugin [${params.processName}] from instance [${params.instanceNo}]. Do you want to proceed? (yes/no)\n\nTo confirm, call this tool again with confirm=true.`,
-                        }],
-                };
-            }
-            const body = {
-                instanceNo: params.instanceNo,
-                processName: params.processName,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/process/remove", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { instanceNo: params.instanceNo, configList: params.configList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/process/add`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_list_port_plugins — Get port plugin list
-    server.tool("ncloud_list_port_plugins", "Get the list of Cloud Insight port monitoring plugins.", {
-        instanceNo: z.string().optional().describe("Server instance number to filter plugins"),
+    server.tool("ncloud_remove_process_plugin", "⚠️ Destructive: Remove process monitoring plugin(s) from a server instance. Set confirm=true to execute.", {
+        instanceNo: z.string().describe("Server instance number"),
+        configList: z.array(z.string()).min(1).describe("Process names to remove"),
+        type: targetType,
+        confirm: z.boolean().optional().default(false).describe("Must be true to actually execute the destructive operation"),
     }, async (params) => {
         try {
-            const body = {};
-            if (params.instanceNo !== undefined)
-                body.instanceNo = params.instanceNo;
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/port", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            if (!params.confirm) {
+                return { content: [{ type: "text", text: `⚠️ This will remove process plugins [${params.configList.join(", ")}] from instance [${params.instanceNo}]. To execute, call again with confirm=true.` }] };
+            }
+            const body = { instanceNo: params.instanceNo, configList: params.configList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/process/remove`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_add_port_plugin — Add a port monitoring plugin
-    server.tool("ncloud_add_port_plugin", "Add a port monitoring plugin to Cloud Insight for monitoring specific ports on a server.", {
-        instanceNo: z.string().describe("Server instance number to add the plugin to"),
-        portNumber: z.number().describe("Port number to monitor"),
+    server.tool("ncloud_set_process_plugins", "Replace the full set of process monitoring plugins for a server instance (sends the entire list).", {
+        instanceNo: z.string().describe("Server instance number"),
+        configList: z.array(z.string()).describe("Full list of process names to monitor (replaces existing)"),
+        type: targetType,
     }, async (params) => {
         try {
-            const body = {
-                instanceNo: params.instanceNo,
-                portNumber: params.portNumber,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/port/add", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { instanceNo: params.instanceNo, configList: params.configList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/process`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_remove_port_plugin — Remove a port monitoring plugin
-    server.tool("ncloud_remove_port_plugin", "⚠️ Destructive: Remove a port monitoring plugin from Cloud Insight.", {
-        instanceNo: z.string().describe("Server instance number"),
-        portNumber: z.number().describe("Port number of the plugin to remove"),
-        confirm: z.boolean().optional().describe("Must be true to execute deletion. If false or omitted, returns a confirmation prompt."),
-    }, async (params) => {
+    // ─── Port plugin ────────────────────────────────────────────────────────
+    server.tool("ncloud_list_port_plugins", "Get the full list of Cloud Insight port monitoring plugins.", {}, async () => {
         try {
-            if (!params.confirm) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `⚠️ This will permanently remove port plugin [${params.portNumber}] from instance [${params.instanceNo}]. Do you want to proceed? (yes/no)\n\nTo confirm, call this tool again with confirm=true.`,
-                        }],
-                };
-            }
-            const body = {
-                instanceNo: params.instanceNo,
-                portNumber: params.portNumber,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/port/remove", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW_SERVER}/port`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_list_file_plugins — Get file plugin list
-    server.tool("ncloud_list_file_plugins", "Get the list of Cloud Insight file monitoring plugins.", {
-        instanceNo: z.string().optional().describe("Server instance number to filter plugins"),
-    }, async (params) => {
+    server.tool("ncloud_get_port_plugin", "Get port monitoring plugin configuration for a specific server instance.", { instanceNo: z.string().describe("Server instance number") }, async (params) => {
         try {
-            const body = {};
-            if (params.instanceNo !== undefined)
-                body.instanceNo = params.instanceNo;
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/file", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW_SERVER}/port/instanceNo/${params.instanceNo}`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_add_file_plugin — Add a file monitoring plugin
-    server.tool("ncloud_add_file_plugin", "Add a file monitoring plugin to Cloud Insight for monitoring specific file paths on a server.", {
-        instanceNo: z.string().describe("Server instance number to add the plugin to"),
-        filePath: z.string().describe("File path to monitor"),
+    server.tool("ncloud_add_port_plugin", "Add port monitoring plugin(s) to a server instance.", {
+        instanceNo: z.string().describe("Server instance number"),
+        portList: z.array(z.number()).min(1).describe("Port numbers to monitor"),
+        type: targetType,
     }, async (params) => {
         try {
-            const body = {
-                instanceNo: params.instanceNo,
-                filePath: params.filePath,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/file/add", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { instanceNo: params.instanceNo, portList: params.portList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/port/add`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_remove_file_plugin — Remove a file monitoring plugin
-    server.tool("ncloud_remove_file_plugin", "⚠️ Destructive: Remove a file monitoring plugin from Cloud Insight.", {
+    server.tool("ncloud_remove_port_plugin", "⚠️ Destructive: Remove port monitoring plugin(s) from a server instance. Set confirm=true to execute.", {
         instanceNo: z.string().describe("Server instance number"),
-        filePath: z.string().describe("File path of the plugin to remove"),
-        confirm: z.boolean().optional().describe("Must be true to execute deletion. If false or omitted, returns a confirmation prompt."),
+        portList: z.array(z.number()).min(1).describe("Port numbers to remove"),
+        type: targetType,
+        confirm: z.boolean().optional().default(false).describe("Must be true to actually execute the destructive operation"),
     }, async (params) => {
         try {
             if (!params.confirm) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `⚠️ This will permanently remove file plugin [${params.filePath}] from instance [${params.instanceNo}]. Do you want to proceed? (yes/no)\n\nTo confirm, call this tool again with confirm=true.`,
-                        }],
-                };
+                return { content: [{ type: "text", text: `⚠️ This will remove port plugins [${params.portList.join(", ")}] from instance [${params.instanceNo}]. To execute, call again with confirm=true.` }] };
             }
-            const body = {
-                instanceNo: params.instanceNo,
-                filePath: params.filePath,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/file/remove", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { instanceNo: params.instanceNo, portList: params.portList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/port/remove`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // --- Custom Resource Tools ---
-    // ncloud_list_custom_resources — Get custom resource list
-    server.tool("ncloud_list_custom_resources", "Get the list of user-defined custom resources in Cloud Insight.", {
-        prodKey: z.string().optional().describe("Product key to filter custom resources"),
+    server.tool("ncloud_set_port_plugins", "Replace the full set of port monitoring plugins for a server instance (sends the entire list).", {
+        instanceNo: z.string().describe("Server instance number"),
+        portList: z.array(z.number()).describe("Full list of port numbers to monitor (replaces existing)"),
+        type: targetType,
     }, async (params) => {
         try {
-            const body = {};
-            if (params.prodKey !== undefined)
-                body.prodKey = params.prodKey;
-            const result = await client.postRequest("/cw_fea/real/cw/api/custom/resource", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { instanceNo: params.instanceNo, portList: params.portList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/port`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_get_custom_resource — Get custom resource details
-    server.tool("ncloud_get_custom_resource", "Get detailed information about a specific user-defined custom resource in Cloud Insight.", {
-        resourceId: z.string().describe("Custom resource ID to retrieve details for"),
-    }, async (params) => {
+    // ─── File plugin ────────────────────────────────────────────────────────
+    server.tool("ncloud_list_file_plugins", "Get the full list of Cloud Insight file monitoring plugins.", {}, async () => {
         try {
-            const body = {
-                resourceId: params.resourceId,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/custom/resource/detail", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW_SERVER}/file`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_create_custom_resource — Create a custom resource
-    server.tool("ncloud_create_custom_resource", "Create a user-defined custom resource in Cloud Insight for custom monitoring targets.", {
-        prodKey: z.string().describe("Product key (cw_key) for the custom schema"),
-        resourceName: z.string().describe("Name of the custom resource"),
-        dimensions: z.record(z.string()).describe("Dimension key-value pairs identifying the resource"),
-    }, async (params) => {
+    server.tool("ncloud_get_file_plugin", "Get file monitoring plugin configuration for a specific server instance.", { instanceNo: z.string().describe("Server instance number") }, async (params) => {
         try {
-            const body = {
-                prodKey: params.prodKey,
-                resourceName: params.resourceName,
-                dimensions: params.dimensions,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/custom/resource/create", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW_SERVER}/file/instanceNo/${params.instanceNo}`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_delete_custom_resource — Delete a custom resource
-    server.tool("ncloud_delete_custom_resource", "⚠️ Destructive: Delete a user-defined custom resource from Cloud Insight.", {
-        resourceId: z.string().describe("Custom resource ID to delete"),
-        confirm: z.boolean().optional().describe("Must be true to execute deletion. If false or omitted, returns a confirmation prompt."),
+    server.tool("ncloud_add_file_plugin", "Add file monitoring plugin(s) to a server instance.", {
+        instanceNo: z.string().describe("Server instance number"),
+        configList: z.array(z.string()).min(1).describe("File paths to monitor"),
+        type: targetType,
     }, async (params) => {
         try {
-            if (!params.confirm) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `⚠️ This will permanently delete custom resource [${params.resourceId}]. Do you want to proceed? (yes/no)\n\nTo confirm, call this tool again with confirm=true.`,
-                        }],
-                };
-            }
-            const body = {
-                resourceId: params.resourceId,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/custom/resource/delete", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { instanceNo: params.instanceNo, configList: params.configList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/file/add`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // --- Schema Tools ---
-    // ncloud_get_schema_keys — Get system schema product keys
-    server.tool("ncloud_get_schema_keys", "Get the list of product keys (cw_key) available in Cloud Insight schema.", {}, async () => {
+    server.tool("ncloud_remove_file_plugin", "⚠️ Destructive: Remove file monitoring plugin(s) from a server instance. Set confirm=true to execute.", {
+        instanceNo: z.string().describe("Server instance number"),
+        configList: z.array(z.string()).min(1).describe("File paths to remove"),
+        type: targetType,
+        confirm: z.boolean().optional().default(false).describe("Must be true to actually execute the destructive operation"),
+    }, async (params) => {
         try {
-            const result = await client.requestRaw("GET", "/cw_fea/real/cw/api/schema/system/list");
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            if (!params.confirm) {
+                return { content: [{ type: "text", text: `⚠️ This will remove file plugins [${params.configList.join(", ")}] from instance [${params.instanceNo}]. To execute, call again with confirm=true.` }] };
+            }
+            const body = { instanceNo: params.instanceNo, configList: params.configList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/file/remove`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_get_product_schema — Get product schema details
-    server.tool("ncloud_get_product_schema", "Get the schema definition for a specific product in Cloud Insight, including available metrics and dimensions.", {
-        prodKey: z.string().describe("Product key (cw_key) to get schema for"),
+    server.tool("ncloud_set_file_plugins", "Replace the full set of file monitoring plugins for a server instance (sends the entire list).", {
+        instanceNo: z.string().describe("Server instance number"),
+        configList: z.array(z.string()).describe("Full list of file paths to monitor (replaces existing)"),
+        type: targetType,
     }, async (params) => {
         try {
-            const body = {
-                prodKey: params.prodKey,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/schema", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { instanceNo: params.instanceNo, configList: params.configList };
+            if (params.type !== undefined)
+                body.type = params.type;
+            const result = await client.postRequest(`${CW_SERVER}/file`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // --- Plugin Detail/Update Tools ---
-    // ncloud_get_process_plugin — Get process plugin for a specific instance
-    server.tool("ncloud_get_process_plugin", "Get process monitoring plugin details for a specific server instance.", {
-        instanceNo: z.string().describe("Server instance number"),
+    // ─── Custom Resource ────────────────────────────────────────────────────
+    server.tool("ncloud_list_custom_resources", "Get the list of user-defined custom resources in Cloud Insight.", {
+        resourceTypeId: z.string().optional().describe("Resource type ID (default 'DEFAULT')"),
+        query: z.string().optional().describe("Filter keyword"),
     }, async (params) => {
         try {
-            const body = { instanceNo: params.instanceNo };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/process/instance", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const q = {};
+            if (params.resourceTypeId !== undefined)
+                q.resourceTypeId = params.resourceTypeId;
+            if (params.query !== undefined)
+                q.query = params.query;
+            const result = await client.requestRaw("GET", `${CW}/custom/resource/list`, q);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_get_port_plugin — Get port plugin for a specific instance
-    server.tool("ncloud_get_port_plugin", "Get port monitoring plugin details for a specific server instance.", {
-        instanceNo: z.string().describe("Server instance number"),
-    }, async (params) => {
+    server.tool("ncloud_get_custom_resource", "Get detailed information about a specific custom resource in Cloud Insight.", { resourceId: z.string().describe("Custom resource ID") }, async (params) => {
         try {
-            const body = { instanceNo: params.instanceNo };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/port/instance", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW}/custom/resource/${params.resourceId}`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_get_file_plugin — Get file plugin for a specific instance
-    server.tool("ncloud_get_file_plugin", "Get file monitoring plugin details for a specific server instance.", {
-        instanceNo: z.string().describe("Server instance number"),
+    server.tool("ncloud_create_custom_resource", "Create a user-defined custom resource in Cloud Insight.", {
+        resourceName: z.string().describe("Name of the custom resource"),
+        resourceData: z
+            .object({
+            organizationCode: z.string().describe("Organization code"),
+            projectId: z.string().describe("Project ID"),
+            serverIp: z.string().describe("Server IP"),
+            serverType: z.string().describe("Server type"),
+            serverName: z.string().optional().describe("Server name"),
+        })
+            .describe("Resource data"),
+        resourceTypeId: z.string().optional().describe("Resource type ID (default 'DEFAULT')"),
+        resourceId: z.string().optional().describe("Resource ID (auto-generated if omitted)"),
     }, async (params) => {
         try {
-            const body = { instanceNo: params.instanceNo };
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/file/instance", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { resourceName: params.resourceName, resourceData: params.resourceData };
+            if (params.resourceTypeId !== undefined)
+                body.resourceTypeId = params.resourceTypeId;
+            if (params.resourceId !== undefined)
+                body.resourceId = params.resourceId;
+            const result = await client.postRequest(`${CW}/custom/resource`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_update_process_plugin — Update process plugin settings
-    server.tool("ncloud_update_process_plugin", "Update process monitoring plugin settings in Cloud Insight.", {
-        instanceNo: z.string().describe("Server instance number"),
-        processName: z.string().describe("Process name to update"),
-        newProcessName: z.string().optional().describe("New process name"),
+    server.tool("ncloud_update_custom_resource", "Update a user-defined custom resource in Cloud Insight.", {
+        resourceId: z.string().describe("Custom resource ID to update"),
+        resourceName: z.string().describe("Name of the custom resource"),
+        resourceData: z
+            .object({
+            organizationCode: z.string().describe("Organization code"),
+            projectId: z.string().describe("Project ID"),
+            serverIp: z.string().describe("Server IP"),
+            serverType: z.string().describe("Server type"),
+            serverName: z.string().optional().describe("Server name"),
+        })
+            .describe("Resource data"),
     }, async (params) => {
         try {
-            const body = {
-                instanceNo: params.instanceNo,
-                processName: params.processName,
-            };
-            if (params.newProcessName !== undefined)
-                body.newProcessName = params.newProcessName;
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/process/update", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { resourceName: params.resourceName, resourceData: params.resourceData };
+            const result = await client.putRequest(`${CW}/custom/resource/${params.resourceId}`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_update_port_plugin — Update port plugin settings
-    server.tool("ncloud_update_port_plugin", "Update port monitoring plugin settings in Cloud Insight.", {
-        instanceNo: z.string().describe("Server instance number"),
-        portNumber: z.number().describe("Current port number"),
-        newPortNumber: z.number().optional().describe("New port number"),
+    server.tool("ncloud_delete_custom_resource", "⚠️ Destructive: Delete a user-defined custom resource from Cloud Insight. Set confirm=true to execute.", {
+        resourceId: z.string().describe("Custom resource ID to delete"),
+        confirm: z.boolean().optional().default(false).describe("Must be true to actually execute the destructive operation"),
     }, async (params) => {
         try {
-            const body = {
-                instanceNo: params.instanceNo,
-                portNumber: params.portNumber,
-            };
-            if (params.newPortNumber !== undefined)
-                body.newPortNumber = params.newPortNumber;
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/port/update", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            if (!params.confirm) {
+                return { content: [{ type: "text", text: `⚠️ This will permanently delete custom resource [${params.resourceId}]. To execute, call again with confirm=true.` }] };
+            }
+            const result = await client.requestRaw("DELETE", `${CW}/custom/resource/${params.resourceId}`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_update_file_plugin — Update file plugin settings
-    server.tool("ncloud_update_file_plugin", "Update file monitoring plugin settings in Cloud Insight.", {
-        instanceNo: z.string().describe("Server instance number"),
-        filePath: z.string().describe("Current file path"),
-        newFilePath: z.string().optional().describe("New file path"),
-    }, async (params) => {
+    // ─── Schema ─────────────────────────────────────────────────────────────
+    server.tool("ncloud_get_schema_keys", "Get the list of system schema product keys (cw_key) available in Cloud Insight.", {}, async () => {
         try {
-            const body = {
-                instanceNo: params.instanceNo,
-                filePath: params.filePath,
-            };
-            if (params.newFilePath !== undefined)
-                body.newFilePath = params.newFilePath;
-            const result = await client.postRequest("/cw_fea/real/cw/api/plugin/file/update", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW}/schema/system/list`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // --- Additional Schema Tools ---
-    // ncloud_create_custom_schema — Create a custom schema
-    server.tool("ncloud_create_custom_schema", "Create a user-defined custom schema in Cloud Insight for custom metrics.", {
-        prodName: z.string().describe("Product name for the custom schema"),
-        fields: z.array(z.object({
-            fieldName: z.string().describe("Field name"),
-            fieldType: z.enum(["STRING", "INTEGER", "LONG", "FLOAT"]).describe("Field data type"),
-            dimension: z.boolean().optional().describe("Whether this field is a dimension (default: false)"),
-        })).describe("Schema field definitions"),
+    server.tool("ncloud_get_product_schema", "Get the schema definition for a specific product in Cloud Insight (metrics and dimensions).", {
+        prodName: z.string().describe("Product name to get schema for"),
+        cw_key: z.string().optional().describe("Product key (cw_key) for custom schema"),
     }, async (params) => {
         try {
-            const body = {
-                prodName: params.prodName,
-                fields: params.fields,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/schema/create", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const q = { prodName: params.prodName };
+            if (params.cw_key !== undefined)
+                q.cw_key = params.cw_key;
+            const result = await client.requestRaw("GET", `${CW}/schema`, q);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_delete_product_schema — Delete a custom schema
-    server.tool("ncloud_delete_product_schema", "⚠️ Destructive: Delete a user-defined custom schema from Cloud Insight.", {
-        prodKey: z.string().describe("Product key (cw_key) of the schema to delete"),
-        confirm: z.boolean().optional().describe("Must be true to execute deletion."),
+    const schemaField = z.object({
+        fieldName: z.string().describe("Field name"),
+        fieldType: z.enum(["STRING", "INTEGER", "LONG", "FLOAT"]).describe("Field data type"),
+        dimension: z.boolean().optional().describe("Whether this field is a dimension"),
+    });
+    server.tool("ncloud_create_custom_schema", "Create a user-defined custom schema in Cloud Insight for custom metrics.", {
+        prodName: z.array(z.string()).describe("Product name(s) for the custom schema"),
+        fields: z.array(schemaField).describe("Schema field definitions"),
+        useCustomResource: z.boolean().optional().describe("Whether to use custom resource (default false)"),
     }, async (params) => {
         try {
-            if (!params.confirm) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `⚠️ This will permanently delete custom schema [${params.prodKey}]. To confirm, call this tool again with confirm=true.`,
-                        }],
-                };
-            }
-            const body = { prodKey: params.prodKey };
-            const result = await client.postRequest("/cw_fea/real/cw/api/schema/delete", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { prodName: params.prodName, fields: params.fields };
+            if (params.useCustomResource !== undefined)
+                body.useCustomResource = params.useCustomResource;
+            const result = await client.postRequest(`${CW}/schema`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_update_product_schema — Update a custom schema
     server.tool("ncloud_update_product_schema", "Update a user-defined custom schema in Cloud Insight.", {
-        prodKey: z.string().describe("Product key (cw_key) of the schema to update"),
-        fields: z.array(z.object({
-            fieldName: z.string().describe("Field name"),
-            fieldType: z.enum(["STRING", "INTEGER", "LONG", "FLOAT"]).describe("Field data type"),
-            dimension: z.boolean().optional().describe("Whether this field is a dimension"),
-        })).describe("Updated schema field definitions"),
+        prodName: z.string().describe("Product name of the schema to update"),
+        cw_key: z.string().describe("Product key (cw_key) of the schema to update"),
+        fields: z.array(schemaField).describe("Updated schema field definitions"),
     }, async (params) => {
         try {
-            const body = {
-                prodKey: params.prodKey,
-                fields: params.fields,
-            };
-            const result = await client.postRequest("/cw_fea/real/cw/api/schema/update", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { prodName: params.prodName, cw_key: params.cw_key, fields: params.fields };
+            const result = await client.putRequest(`${CW}/schema`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_get_extended_status — Get extended metric status
-    server.tool("ncloud_get_extended_status", "Get the Extended Metric collection status for a specific instance in Cloud Insight.", {
-        instanceNo: z.string().describe("Server instance number to check extended metric status"),
+    server.tool("ncloud_delete_product_schema", "⚠️ Destructive: Delete a user-defined custom schema from Cloud Insight. Set confirm=true to execute.", {
+        prodName: z.string().describe("Product name of the schema to delete"),
+        cw_key: z.string().describe("Product key (cw_key) of the schema to delete"),
+        confirm: z.boolean().optional().default(false).describe("Must be true to actually execute the destructive operation"),
     }, async (params) => {
         try {
-            const body = { instanceNo: params.instanceNo };
-            const result = await client.postRequest("/cw_fea/real/cw/api/schema/extended/status", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            if (!params.confirm) {
+                return { content: [{ type: "text", text: `⚠️ This will permanently delete custom schema [${params.prodName} / ${params.cw_key}]. To execute, call again with confirm=true.` }] };
+            }
+            const result = await client.requestRaw("DELETE", `${CW}/schema`, { cw_key: params.cw_key, prodName: params.prodName });
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_update_extended_enable — Enable extended metric collection
-    server.tool("ncloud_update_extended_enable", "Enable Extended Metric collection for a specific instance in Cloud Insight.", {
-        instanceNo: z.string().describe("Server instance number to enable extended metrics for"),
+    // ─── Extended metric ─────────────────────────────────────────────────────
+    server.tool("ncloud_get_extended_status", "Get the Extended Metric collection status for servers in Cloud Insight.", {
+        prodKey: z.string().describe("Product key (cw_key)"),
+        servers: z.array(z.string()).describe("Server instance numbers to check"),
     }, async (params) => {
         try {
-            const body = { instanceNo: params.instanceNo };
-            const result = await client.postRequest("/cw_fea/real/cw/api/schema/extended/enable", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const body = { prodKey: params.prodKey, servers: params.servers };
+            const result = await client.postRequest(`${CW}/schema/extended/status`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_update_extended_disable — Disable extended metric collection
-    server.tool("ncloud_update_extended_disable", "Disable Extended Metric collection for a specific instance in Cloud Insight.", {
-        instanceNo: z.string().describe("Server instance number to disable extended metrics for"),
+    server.tool("ncloud_update_extended_enable", "Enable Extended Metric collection for instances in Cloud Insight.", {
+        cw_key: z.string().describe("Product key (cw_key)"),
+        instanceIds: z.string().describe("Comma-separated server instance numbers"),
     }, async (params) => {
         try {
-            const body = { instanceNo: params.instanceNo };
-            const result = await client.postRequest("/cw_fea/real/cw/api/schema/extended/disable", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("PUT", `${CW}/schema/extended/enable`, { cw_key: params.cw_key, instanceIds: params.instanceIds });
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // --- Custom Resource Update ---
-    // ncloud_update_custom_resource — Update a custom resource
-    server.tool("ncloud_update_custom_resource", "Update a user-defined custom resource in Cloud Insight.", {
-        resourceId: z.string().describe("Custom resource ID to update"),
-        resourceName: z.string().optional().describe("New name for the custom resource"),
-        dimensions: z.record(z.string()).optional().describe("Updated dimension key-value pairs"),
+    server.tool("ncloud_update_extended_disable", "Disable Extended Metric collection for instances in Cloud Insight.", {
+        cw_key: z.string().describe("Product key (cw_key)"),
+        instanceIds: z.string().describe("Comma-separated server instance numbers"),
     }, async (params) => {
         try {
-            const body = {
-                resourceId: params.resourceId,
-            };
-            if (params.resourceName !== undefined)
-                body.resourceName = params.resourceName;
-            if (params.dimensions !== undefined)
-                body.dimensions = params.dimensions;
-            const result = await client.postRequest("/cw_fea/real/cw/api/custom/resource/update", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("PUT", `${CW}/schema/extended/disable`, { cw_key: params.cw_key, instanceIds: params.instanceIds });
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // --- Planned Maintenance Tools ---
-    // ncloud_list_maintenances — Get planned maintenance list
-    server.tool("ncloud_list_maintenances", "Get the list of planned maintenance schedules in Cloud Insight.", {}, async () => {
+    // ─── Planned Maintenance ─────────────────────────────────────────────────
+    server.tool("ncloud_list_maintenances", "Get the list of planned maintenance schedules in Cloud Insight (paged). The API requires a filter: either a time range (from/to/timeType) OR a resource (resourceId+productKey). If none is given, a default ±180-day window by startTime is applied.", {
+        pageNum: z.number().optional().default(1).describe("Page number (>= 1)"),
+        pageSize: z.number().optional().default(100).describe("Page size (>= 1)"),
+        from: z.number().optional().describe("Filter start (epoch ms), used with 'to' and 'timeType'"),
+        to: z.number().optional().describe("Filter end (epoch ms)"),
+        timeType: z.enum(["startTime", "endTime"]).optional().describe("Which time the from/to filter applies to (default startTime)"),
+        resourceId: z.string().optional().describe("Filter by resource ID (use together with productKey instead of a time range)"),
+        productKey: z.string().optional().describe("Filter by product key (use together with resourceId)"),
+    }, async (params) => {
         try {
-            const result = await client.postRequest("/cw_fea/real/cw/api/maintenance/list", {});
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const q = { pageNum: params.pageNum ?? 1, pageSize: params.pageSize ?? 100 };
+            if (params.resourceId !== undefined && params.productKey !== undefined) {
+                // 리소스 필터 모드
+                q.resourceId = params.resourceId;
+                q.productKey = params.productKey;
+            }
+            else {
+                // 시간범위 필터 모드 — 미지정 시 ±180일 기본창 주입(API가 필터를 요구하므로 무인자 400 방지)
+                const DAY = 86_400_000;
+                q.from = params.from ?? Date.now() - 180 * DAY;
+                q.to = params.to ?? Date.now() + 180 * DAY;
+                q.timeType = params.timeType ?? "startTime";
+            }
+            const result = await client.requestRaw("GET", `${CW}/planned-maintenances`, q);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_get_maintenance_detail — Get planned maintenance detail
-    server.tool("ncloud_get_maintenance_detail", "Get detailed information about a specific planned maintenance schedule.", {
-        maintenanceId: z.string().describe("Maintenance ID to retrieve details for"),
-    }, async (params) => {
+    server.tool("ncloud_get_maintenance_detail", "Get detailed information about a specific planned maintenance schedule.", { maintenanceId: z.string().describe("Planned maintenance ID") }, async (params) => {
         try {
-            const body = { maintenanceId: params.maintenanceId };
-            const result = await client.postRequest("/cw_fea/real/cw/api/maintenance/detail", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("GET", `${CW}/planned-maintenances/${params.maintenanceId}`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_create_maintenance — Create a planned maintenance schedule
     server.tool("ncloud_create_maintenance", "Create a new planned maintenance schedule in Cloud Insight.", {
         title: z.string().describe("Maintenance title"),
         startTime: z.number().describe("Start time in Unix epoch milliseconds"),
         endTime: z.number().describe("End time in Unix epoch milliseconds"),
-        description: z.string().optional().describe("Maintenance description"),
+        dimensions: z.record(z.unknown()).describe("Target dimensions (resource identifiers)"),
+        desc: z.string().optional().describe("Maintenance description"),
     }, async (params) => {
         try {
             const body = {
                 title: params.title,
                 startTime: params.startTime,
                 endTime: params.endTime,
+                dimensions: params.dimensions,
             };
-            if (params.description !== undefined)
-                body.description = params.description;
-            const result = await client.postRequest("/cw_fea/real/cw/api/maintenance/create", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            if (params.desc !== undefined)
+                body.desc = params.desc;
+            const result = await client.postRequest(`${CW}/planned-maintenances`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_update_maintenance — Update a planned maintenance schedule
     server.tool("ncloud_update_maintenance", "Update an existing planned maintenance schedule in Cloud Insight.", {
-        maintenanceId: z.string().describe("Maintenance ID to update"),
-        title: z.string().optional().describe("New maintenance title"),
-        startTime: z.number().optional().describe("New start time in Unix epoch milliseconds"),
-        endTime: z.number().optional().describe("New end time in Unix epoch milliseconds"),
-        description: z.string().optional().describe("New maintenance description"),
+        maintenanceId: z.string().describe("Planned maintenance ID to update"),
+        title: z.string().optional().describe("Maintenance title"),
+        startTime: z.number().optional().describe("Start time in Unix epoch milliseconds"),
+        endTime: z.number().optional().describe("End time in Unix epoch milliseconds"),
+        dimensions: z.record(z.unknown()).optional().describe("Target dimensions"),
+        desc: z.string().optional().describe("Maintenance description"),
     }, async (params) => {
         try {
-            const body = {
-                maintenanceId: params.maintenanceId,
-            };
+            const body = {};
             if (params.title !== undefined)
                 body.title = params.title;
             if (params.startTime !== undefined)
                 body.startTime = params.startTime;
             if (params.endTime !== undefined)
                 body.endTime = params.endTime;
-            if (params.description !== undefined)
-                body.description = params.description;
-            const result = await client.postRequest("/cw_fea/real/cw/api/maintenance/update", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            if (params.dimensions !== undefined)
+                body.dimensions = params.dimensions;
+            if (params.desc !== undefined)
+                body.desc = params.desc;
+            const result = await client.putRequest(`${CW}/planned-maintenances/${params.maintenanceId}`, body);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };
         }
     });
-    // ncloud_delete_maintenance — Delete a planned maintenance schedule
-    server.tool("ncloud_delete_maintenance", "⚠️ Destructive: Delete a planned maintenance schedule from Cloud Insight.", {
-        maintenanceId: z.string().describe("Maintenance ID to delete"),
-        confirm: z.boolean().optional().describe("Must be true to execute deletion."),
+    server.tool("ncloud_delete_maintenance", "⚠️ Destructive: Delete a planned maintenance schedule from Cloud Insight. Set confirm=true to execute.", {
+        maintenanceId: z.string().describe("Planned maintenance ID to delete"),
+        confirm: z.boolean().optional().default(false).describe("Must be true to actually execute the destructive operation"),
     }, async (params) => {
         try {
             if (!params.confirm) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: `⚠️ This will permanently delete maintenance schedule [${params.maintenanceId}]. To confirm, call this tool again with confirm=true.`,
-                        }],
-                };
+                return { content: [{ type: "text", text: `⚠️ This will permanently delete maintenance schedule [${params.maintenanceId}]. To execute, call again with confirm=true.` }] };
             }
-            const body = { maintenanceId: params.maintenanceId };
-            const result = await client.postRequest("/cw_fea/real/cw/api/maintenance/delete", body);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            const result = await client.requestRaw("DELETE", `${CW}/planned-maintenances/${params.maintenanceId}`);
+            return toolText(result);
         }
         catch (error) {
             return { content: [{ type: "text", text: error.message }], isError: true };