ncloud-mcp-server 1.0.0

package/dist/tools/activity-tracer.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+export function registerActivityTracerTools(server, client) {
+    // ncloud_get_activity_logs — Get activity list via POST /api/v1/activities
+    server.tool("ncloud_get_activity_logs", "Get cloud activity tracer logs with filtering by period, service, and user. Uses POST method with JSON body. Time parameters accept ISO 8601 strings and are converted to epoch milliseconds internally.", {
+        startTime: z.string().describe("Start time in ISO 8601 format (e.g., \"2024-01-01T00:00:00Z\"). Converted to epoch ms internally. (Required)"),
+        endTime: z.string().describe("End time in ISO 8601 format (e.g., \"2024-01-31T23:59:59Z\"). Converted to epoch ms internally. (Required)"),
+        page: z.number().optional().describe("Page number (0-based, default 0)"),
+        size: z.number().optional().describe("Page size (default 20)"),
+        nrn: z.string().optional().describe("Ncloud Resource Name to filter specific resource activities"),
+    }, async (params) => {
+        try {
+            const fromEventTime = new Date(params.startTime).getTime();
+            const toEventTime = new Date(params.endTime).getTime();
+            if (isNaN(fromEventTime)) {
+                return { content: [{ type: "text", text: "startTime이 유효한 ISO 8601 형식이 아닙니다." }], isError: true };
+            }
+            if (isNaN(toEventTime)) {
+                return { content: [{ type: "text", text: "endTime이 유효한 ISO 8601 형식이 아닙니다." }], isError: true };
+            }
+            const body = {
+                fromEventTime,
+                toEventTime,
+            };
+            if (params.page !== undefined)
+                body.page = params.page;
+            if (params.size !== undefined)
+                body.size = params.size;
+            if (params.nrn !== undefined)
+                body.nrn = params.nrn;
+            const result = await client.postRequest("/api/v1/activities", body);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    });
+    // ncloud_get_activity_detail — Get detailed information of a specific activity
+    server.tool("ncloud_get_activity_detail", "Get detailed information about a specific cloud activity event. Queries the activity list with a narrow time range and filters by activityId.", {
+        activityId: z.string().describe("The activity ID to get details for"),
+        eventTime: z.string().describe("Approximate event time in ISO 8601 format to narrow the search window (e.g., \"2024-01-15T10:30:00Z\")"),
+    }, async (params) => {
+        try {
+            const eventTimeMs = new Date(params.eventTime).getTime();
+            if (isNaN(eventTimeMs)) {
+                return { content: [{ type: "text", text: "eventTime이 유효한 ISO 8601 형식이 아닙니다." }], isError: true };
+            }
+            // Search within a 1-hour window around the event time
+            const fromEventTime = eventTimeMs - 30 * 60 * 1000;
+            const toEventTime = eventTimeMs + 30 * 60 * 1000;
+            const body = {
+                fromEventTime,
+                toEventTime,
+                size: 100,
+            };
+            const result = await client.postRequest("/api/v1/activities", body);
+            // Filter by activityId from the response
+            if (result && Array.isArray(result.content)) {
+                const activity = result.content.find((item) => item.activityId === params.activityId);
+                if (activity) {
+                    return { content: [{ type: "text", text: JSON.stringify(activity, null, 2) }] };
+                }
+            }
+            // If result is an array directly
+            if (Array.isArray(result)) {
+                const activity = result.find((item) => item.activityId === params.activityId);
+                if (activity) {
+                    return { content: [{ type: "text", text: JSON.stringify(activity, null, 2) }] };
+                }
+            }
+            return { content: [{ type: "text", text: `activityId '${params.activityId}'에 해당하는 활동을 찾을 수 없습니다. eventTime 범위를 확인해주세요.\n\n전체 응답:\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=activity-tracer.js.map

package/dist/tools/activity-tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-tracer.js","sourceRoot":"","sources":["../../src/tools/activity-tracer.ts"],"names":[],"mappings":"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"}

package/dist/tools/analytics-cdss.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NcloudClient } from "../client/ncloud-client.js";
+export declare function registerCloudDataStreamingTools(server: McpServer, client: NcloudClient): void;