@teamnetwork-nz/prtg-mcp-server 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/README.md +209 -0
  2. package/dist/client.d.ts +26 -0
  3. package/dist/client.d.ts.map +1 -0
  4. package/dist/client.js +150 -0
  5. package/dist/client.js.map +1 -0
  6. package/dist/index.d.ts +3 -0
  7. package/dist/index.d.ts.map +1 -0
  8. package/dist/index.js +114 -0
  9. package/dist/index.js.map +1 -0
  10. package/dist/tools/actions.d.ts +4 -0
  11. package/dist/tools/actions.d.ts.map +1 -0
  12. package/dist/tools/actions.js +83 -0
  13. package/dist/tools/actions.js.map +1 -0
  14. package/dist/tools/devices.d.ts +4 -0
  15. package/dist/tools/devices.d.ts.map +1 -0
  16. package/dist/tools/devices.js +99 -0
  17. package/dist/tools/devices.js.map +1 -0
  18. package/dist/tools/metrics.d.ts +4 -0
  19. package/dist/tools/metrics.d.ts.map +1 -0
  20. package/dist/tools/metrics.js +70 -0
  21. package/dist/tools/metrics.js.map +1 -0
  22. package/dist/tools/navigation.d.ts +4 -0
  23. package/dist/tools/navigation.d.ts.map +1 -0
  24. package/dist/tools/navigation.js +121 -0
  25. package/dist/tools/navigation.js.map +1 -0
  26. package/dist/tools/sensors.d.ts +4 -0
  27. package/dist/tools/sensors.d.ts.map +1 -0
  28. package/dist/tools/sensors.js +131 -0
  29. package/dist/tools/sensors.js.map +1 -0
  30. package/dist/tools/system.d.ts +4 -0
  31. package/dist/tools/system.d.ts.map +1 -0
  32. package/dist/tools/system.js +56 -0
  33. package/dist/tools/system.js.map +1 -0
  34. package/dist/types.d.ts +109 -0
  35. package/dist/types.d.ts.map +1 -0
  36. package/dist/types.js +3 -0
  37. package/dist/types.js.map +1 -0
  38. package/dist/tz.d.ts +28 -0
  39. package/dist/tz.d.ts.map +1 -0
  40. package/dist/tz.js +128 -0
  41. package/dist/tz.js.map +1 -0
  42. package/package.json +30 -0
@@ -0,0 +1,99 @@
1
+ import { z } from "zod";
2
+ import { transformDates } from "../tz.js";
3
+ export function registerDeviceTools(server, client) {
4
+ server.registerTool("list_devices", {
5
+ title: "List Devices",
6
+ description: "List monitoring devices with optional filters. " +
7
+ "Name filter is a case-insensitive substring match (done locally).",
8
+ inputSchema: {
9
+ name: z.string().optional().describe("Filter by name — case-insensitive substring"),
10
+ parentid: z.string().optional().describe("Filter by parent group/probe ID"),
11
+ tags: z.string().optional().describe("Filter by tag value (exact match)"),
12
+ host: z.string().optional().describe("Filter by hostname or IP (substring, done locally)"),
13
+ limit: z
14
+ .number()
15
+ .int()
16
+ .min(1)
17
+ .max(3000)
18
+ .optional()
19
+ .default(100)
20
+ .describe("Maximum results (default 100)"),
21
+ },
22
+ }, async ({ name, parentid, tags, host, limit }) => {
23
+ const parts = [];
24
+ if (parentid)
25
+ parts.push(`parentid = "${parentid}"`);
26
+ if (tags)
27
+ parts.push(`basic.tags contains "${tags}"`);
28
+ const filter = parts.join(" and ");
29
+ const devices = await client.getAll("/api/v2/experimental/devices", { ...(filter ? { filter } : {}), include: "basic" }, limit ?? 100);
30
+ const results = devices
31
+ .filter((d) => !name || d.name.toLowerCase().includes(name.toLowerCase()))
32
+ .filter((d) => !host || (d.basic?.host ?? "").toLowerCase().includes(host.toLowerCase()));
33
+ return {
34
+ content: [{ type: "text", text: JSON.stringify(transformDates(results), null, 2) }],
35
+ };
36
+ });
37
+ server.registerTool("get_device", {
38
+ title: "Get Device",
39
+ description: "Get full details for a single device by its PRTG object ID.",
40
+ inputSchema: {
41
+ id: z.string().describe("PRTG device object ID"),
42
+ },
43
+ }, async ({ id }) => {
44
+ const devices = await client.getAll("/api/v2/experimental/devices", { filter: `id = "${id}"`, include: "*" }, 1);
45
+ if (devices.length === 0) {
46
+ return {
47
+ content: [{ type: "text", text: `No device found with ID ${id}.` }],
48
+ isError: true,
49
+ };
50
+ }
51
+ return {
52
+ content: [{ type: "text", text: JSON.stringify(transformDates(devices[0]), null, 2) }],
53
+ };
54
+ });
55
+ server.registerTool("list_groups", {
56
+ title: "List Groups",
57
+ description: "List PRTG groups (logical containers for devices).",
58
+ inputSchema: {
59
+ name: z.string().optional().describe("Filter by name — case-insensitive substring"),
60
+ parentid: z.string().optional().describe("Filter by parent probe/group ID"),
61
+ limit: z
62
+ .number()
63
+ .int()
64
+ .min(1)
65
+ .max(3000)
66
+ .optional()
67
+ .default(200)
68
+ .describe("Maximum results (default 200)"),
69
+ },
70
+ }, async ({ name, parentid, limit }) => {
71
+ const parts = [];
72
+ if (parentid)
73
+ parts.push(`parentid = "${parentid}"`);
74
+ const filter = parts.join(" and ");
75
+ const groups = await client.getAll("/api/v2/experimental/groups", { ...(filter ? { filter } : {}) }, limit ?? 200);
76
+ const results = name
77
+ ? groups.filter((g) => g.name.toLowerCase().includes(name.toLowerCase()))
78
+ : groups;
79
+ return {
80
+ content: [{ type: "text", text: JSON.stringify(transformDates(results), null, 2) }],
81
+ };
82
+ });
83
+ server.registerTool("list_probes", {
84
+ title: "List Probes",
85
+ description: "List PRTG probes (top-level monitoring nodes).",
86
+ inputSchema: {
87
+ name: z.string().optional().describe("Filter by name — case-insensitive substring"),
88
+ },
89
+ }, async ({ name }) => {
90
+ const probes = await client.getAll("/api/v2/experimental/probes", {});
91
+ const results = name
92
+ ? probes.filter((p) => p.name.toLowerCase().includes(name.toLowerCase()))
93
+ : probes;
94
+ return {
95
+ content: [{ type: "text", text: JSON.stringify(transformDates(results), null, 2) }],
96
+ };
97
+ });
98
+ }
99
+ //# sourceMappingURL=devices.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/tools/devices.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { PrtgClient } from "../client.js";
3
+ export declare function registerMetricsTools(server: McpServer, client: PrtgClient): void;
4
+ //# sourceMappingURL=metrics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/tools/metrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA8FhF"}
@@ -0,0 +1,70 @@
1
+ import { z } from "zod";
2
+ import { getEffectiveTz, localToUtc, transformDates } from "../tz.js";
3
+ const TIMESERIES_TYPES = ["live", "short", "medium", "long"];
4
+ export function registerMetricsTools(server, client) {
5
+ server.registerTool("get_channels", {
6
+ title: "Get Sensor Channels",
7
+ description: "Get current channel values for a sensor, including last measured value, unit, min/max/average.",
8
+ inputSchema: {
9
+ sensor_id: z.string().describe("PRTG sensor object ID"),
10
+ },
11
+ }, async ({ sensor_id }) => {
12
+ const channels = await client.getAll("/api/v2/experimental/channels", { filter: `parentid = "${sensor_id}"`, include: "basic" });
13
+ if (channels.length === 0) {
14
+ return {
15
+ content: [
16
+ {
17
+ type: "text",
18
+ text: `No channels found for sensor ${sensor_id}. Verify the sensor ID is correct.`,
19
+ },
20
+ ],
21
+ isError: true,
22
+ };
23
+ }
24
+ return {
25
+ content: [{ type: "text", text: JSON.stringify(transformDates(channels), null, 2) }],
26
+ };
27
+ });
28
+ server.registerTool("get_timeseries", {
29
+ title: "Get Sensor Timeseries",
30
+ description: "Get historical time series data for a sensor using a predefined timeframe.\n" +
31
+ "- live: last ~30 minutes (high resolution)\n" +
32
+ "- short: last ~2 hours\n" +
33
+ "- medium: last ~24 hours\n" +
34
+ "- long: last ~30 days",
35
+ inputSchema: {
36
+ sensor_id: z.string().describe("PRTG sensor object ID"),
37
+ timeframe: z
38
+ .enum(TIMESERIES_TYPES)
39
+ .default("medium")
40
+ .describe("Predefined timeframe (default: medium = ~24h)"),
41
+ },
42
+ }, async ({ sensor_id, timeframe }) => {
43
+ const data = await client.get(`/api/v2/experimental/timeseries/${sensor_id}/${timeframe}`);
44
+ return {
45
+ content: [{ type: "text", text: JSON.stringify(transformDates(data), null, 2) }],
46
+ };
47
+ });
48
+ const tz = getEffectiveTz();
49
+ server.registerTool("get_timeseries_custom", {
50
+ title: "Get Sensor Timeseries (Custom Range)",
51
+ description: `Get historical time series data for a sensor over a custom date/time range. ` +
52
+ `Provide timestamps as local time (${tz}) without a timezone suffix — ` +
53
+ `e.g. 2024-01-15T09:00:00. Timezone conversion is handled automatically.`,
54
+ inputSchema: {
55
+ sensor_id: z.string().describe("PRTG sensor object ID"),
56
+ start: z
57
+ .string()
58
+ .describe(`Start of range in local time (${tz}) — e.g. 2024-01-15T00:00:00`),
59
+ end: z
60
+ .string()
61
+ .describe(`End of range in local time (${tz}) — e.g. 2024-01-15T23:59:59`),
62
+ },
63
+ }, async ({ sensor_id, start, end }) => {
64
+ const data = await client.get(`/api/v2/experimental/timeseries/${sensor_id}`, { start: localToUtc(start), end: localToUtc(end) });
65
+ return {
66
+ content: [{ type: "text", text: JSON.stringify(transformDates(data), null, 2) }],
67
+ };
68
+ });
69
+ }
70
+ //# sourceMappingURL=metrics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/tools/metrics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { PrtgClient } from "../client.js";
3
+ export declare function registerNavigationTools(server: McpServer, client: PrtgClient): void;
4
+ //# sourceMappingURL=navigation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAkB/C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAiJnF"}
@@ -0,0 +1,121 @@
1
+ import { z } from "zod";
2
+ import { transformDates } from "../tz.js";
3
+ export function registerNavigationTools(server, client) {
4
+ server.registerTool("get_hierarchy", {
5
+ title: "Get PRTG Hierarchy",
6
+ description: "Returns the full PRTG object tree: probes → groups → devices. " +
7
+ "Include sensors at the device level by setting include_sensors=true (may be slow on large installations).",
8
+ inputSchema: {
9
+ include_sensors: z
10
+ .boolean()
11
+ .optional()
12
+ .default(false)
13
+ .describe("Include sensors under each device (default false)"),
14
+ probeid: z
15
+ .string()
16
+ .optional()
17
+ .describe("Limit hierarchy to a specific probe ID"),
18
+ },
19
+ }, async ({ include_sensors, probeid }) => {
20
+ const [probes, groups, devices] = await Promise.all([
21
+ client.getAll("/api/v2/experimental/probes", probeid ? { filter: `id = "${probeid}"` } : {}),
22
+ client.getAll("/api/v2/experimental/groups", {}),
23
+ client.getAll("/api/v2/experimental/devices", { include: "basic" }),
24
+ ]);
25
+ let sensors = [];
26
+ if (include_sensors) {
27
+ sensors = await client.getAll("/api/v2/experimental/sensors", {});
28
+ }
29
+ // Build parent-keyed maps
30
+ const groupsByParent = new Map();
31
+ for (const g of groups) {
32
+ const arr = groupsByParent.get(g.parent.id) ?? [];
33
+ arr.push(g);
34
+ groupsByParent.set(g.parent.id, arr);
35
+ }
36
+ const devicesByParent = new Map();
37
+ for (const d of devices) {
38
+ const arr = devicesByParent.get(d.parent.id) ?? [];
39
+ arr.push(d);
40
+ devicesByParent.set(d.parent.id, arr);
41
+ }
42
+ const sensorsByParent = new Map();
43
+ for (const s of sensors) {
44
+ const arr = sensorsByParent.get(s.parent.id) ?? [];
45
+ arr.push(s);
46
+ sensorsByParent.set(s.parent.id, arr);
47
+ }
48
+ function attachDevices(parentId) {
49
+ return (devicesByParent.get(parentId) ?? []).map((d) => ({
50
+ ...d,
51
+ ...(include_sensors ? { sensors: sensorsByParent.get(d.id) ?? [] } : {}),
52
+ }));
53
+ }
54
+ function attachGroups(parentId) {
55
+ return (groupsByParent.get(parentId) ?? []).map((g) => ({
56
+ ...g,
57
+ devices: attachDevices(g.id),
58
+ groups: attachGroups(g.id),
59
+ }));
60
+ }
61
+ const tree = probes.map((p) => ({
62
+ ...p,
63
+ groups: attachGroups(p.id),
64
+ devices: attachDevices(p.id),
65
+ }));
66
+ return {
67
+ content: [{ type: "text", text: JSON.stringify(transformDates(tree), null, 2) }],
68
+ };
69
+ });
70
+ server.registerTool("search", {
71
+ title: "Search PRTG",
72
+ description: "Universal name search across sensors, devices, and groups simultaneously. " +
73
+ "Returns results grouped by object type.",
74
+ inputSchema: {
75
+ query: z.string().min(1).describe("Search term (substring match on name)"),
76
+ types: z
77
+ .array(z.enum(["sensor", "device", "group"]))
78
+ .optional()
79
+ .default(["sensor", "device", "group"])
80
+ .describe("Object types to search (default: all)"),
81
+ limit: z
82
+ .number()
83
+ .int()
84
+ .min(1)
85
+ .max(500)
86
+ .optional()
87
+ .default(50)
88
+ .describe("Max results per object type (default 50)"),
89
+ },
90
+ }, async ({ query, types, limit }) => {
91
+ const searchTypes = types ?? ["sensor", "device", "group"];
92
+ const perType = limit ?? 50;
93
+ const q = query.toLowerCase();
94
+ // PRTG v2 does not support substring name filtering — fetch all and filter locally
95
+ const endpointMap = {
96
+ sensor: "/api/v2/experimental/sensors",
97
+ device: "/api/v2/experimental/devices",
98
+ group: "/api/v2/experimental/groups",
99
+ };
100
+ const results = await Promise.all(searchTypes.map(async (t) => {
101
+ const all = await client.getAll(endpointMap[t], {}, 3000);
102
+ const items = all
103
+ .filter((item) => item.name.toLowerCase().includes(q))
104
+ .slice(0, perType);
105
+ return { type: t, items };
106
+ }));
107
+ const output = Object.fromEntries(results.map((r) => [r.type, r.items]));
108
+ const total = results.reduce((sum, r) => sum + r.items.length, 0);
109
+ return {
110
+ content: [
111
+ {
112
+ type: "text",
113
+ text: total === 0
114
+ ? `No results found for "${query}".`
115
+ : JSON.stringify(transformDates(output), null, 2),
116
+ },
117
+ ],
118
+ };
119
+ });
120
+ }
121
+ //# sourceMappingURL=navigation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { PrtgClient } from "../client.js";
3
+ export declare function registerSensorTools(server: McpServer, client: PrtgClient): void;
4
+ //# sourceMappingURL=sensors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sensors.d.ts","sourceRoot":"","sources":["../../src/tools/sensors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA6B/C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAuI/E"}
@@ -0,0 +1,131 @@
1
+ import { z } from "zod";
2
+ import { transformDates } from "../tz.js";
3
+ // PRTG v2 API returns uppercase status values
4
+ const STATUS_VALUES = [
5
+ "UP", "DOWN", "WARNING", "UNKNOWN", "COLLECTING", "DISCONNECTED",
6
+ "PAUSEDBYUSER", "PAUSEDBYDEPENDENCY", "PAUSEDBYSCHEDULE",
7
+ "UNUSUAL", "PAUSEDBYLICENSE", "ACKNOWLEDGED",
8
+ ];
9
+ const ALERT_STATUS_VALUES = ["DOWN", "WARNING", "UNUSUAL", "ACKNOWLEDGED"];
10
+ // Note: PRTG v2 filter does not support substring matching on name.
11
+ // Name filtering is done client-side after fetching.
12
+ function buildSensorApiFilter(opts) {
13
+ const parts = [];
14
+ if (opts.status)
15
+ parts.push(`status = ${opts.status}`);
16
+ if (opts.parentid)
17
+ parts.push(`parentid = "${opts.parentid}"`);
18
+ if (opts.tags)
19
+ parts.push(`basic.tags contains "${opts.tags}"`);
20
+ if (opts.kind)
21
+ parts.push(`kind = "${opts.kind}"`);
22
+ return parts.join(" and ");
23
+ }
24
+ export function registerSensorTools(server, client) {
25
+ server.registerTool("list_sensors", {
26
+ title: "List Sensors",
27
+ description: "List sensors with optional filters. " +
28
+ "Note: name filter is a case-insensitive substring match (done locally); " +
29
+ "all other filters are applied server-side.",
30
+ inputSchema: {
31
+ status: z
32
+ .enum(STATUS_VALUES)
33
+ .optional()
34
+ .describe("Filter by sensor status (e.g. UP, DOWN, WARNING)"),
35
+ name: z
36
+ .string()
37
+ .optional()
38
+ .describe("Filter by name — case-insensitive substring match"),
39
+ parentid: z
40
+ .string()
41
+ .optional()
42
+ .describe("Filter by parent device/group ID"),
43
+ tags: z
44
+ .string()
45
+ .optional()
46
+ .describe("Filter by tag value (single tag, exact match)"),
47
+ kind: z
48
+ .string()
49
+ .optional()
50
+ .describe("Filter by sensor kind (e.g. ping, snmptraffic, http)"),
51
+ limit: z
52
+ .number()
53
+ .int()
54
+ .min(1)
55
+ .max(3000)
56
+ .optional()
57
+ .default(100)
58
+ .describe("Maximum number of results (default 100)"),
59
+ },
60
+ }, async ({ status, name, parentid, tags, kind, limit }) => {
61
+ const filter = buildSensorApiFilter({ status, parentid, tags, kind });
62
+ const sensors = await client.getAll("/api/v2/experimental/sensors", { ...(filter ? { filter } : {}), include: "basic" }, limit ?? 100);
63
+ const results = name
64
+ ? sensors.filter((s) => s.name.toLowerCase().includes(name.toLowerCase()))
65
+ : sensors;
66
+ return {
67
+ content: [{ type: "text", text: JSON.stringify(transformDates(results), null, 2) }],
68
+ };
69
+ });
70
+ server.registerTool("get_sensor", {
71
+ title: "Get Sensor",
72
+ description: "Get full details for a single sensor by its PRTG object ID.",
73
+ inputSchema: {
74
+ id: z.string().describe("PRTG sensor object ID"),
75
+ },
76
+ }, async ({ id }) => {
77
+ const sensors = await client.getAll("/api/v2/experimental/sensors", { filter: `id = "${id}"`, include: "*" }, 1);
78
+ if (sensors.length === 0) {
79
+ return {
80
+ content: [{ type: "text", text: `No sensor found with ID ${id}.` }],
81
+ isError: true,
82
+ };
83
+ }
84
+ return {
85
+ content: [{ type: "text", text: JSON.stringify(transformDates(sensors[0]), null, 2) }],
86
+ };
87
+ });
88
+ server.registerTool("list_alerts", {
89
+ title: "List Alerts",
90
+ description: "List sensors currently in an alert state: DOWN, WARNING, UNUSUAL, or ACKNOWLEDGED.",
91
+ inputSchema: {
92
+ status: z
93
+ .enum(ALERT_STATUS_VALUES)
94
+ .optional()
95
+ .describe("Specific alert status (default: all alert states)"),
96
+ name: z.string().optional().describe("Filter by sensor name (substring)"),
97
+ parentid: z.string().optional().describe("Limit to a specific device/group ID"),
98
+ limit: z
99
+ .number()
100
+ .int()
101
+ .min(1)
102
+ .max(3000)
103
+ .optional()
104
+ .default(200)
105
+ .describe("Maximum results (default 200)"),
106
+ },
107
+ }, async ({ status, name, parentid, limit }) => {
108
+ const statusFilter = status
109
+ ? `status = ${status}`
110
+ : "status = DOWN or status = WARNING or status = UNUSUAL or status = ACKNOWLEDGED";
111
+ const parts = [`(${statusFilter})`];
112
+ if (parentid)
113
+ parts.push(`parentid = "${parentid}"`);
114
+ const filter = parts.join(" and ");
115
+ const sensors = await client.getAll("/api/v2/experimental/sensors", { filter, include: "basic" }, limit ?? 200);
116
+ const results = name
117
+ ? sensors.filter((s) => s.name.toLowerCase().includes(name.toLowerCase()))
118
+ : sensors;
119
+ return {
120
+ content: [
121
+ {
122
+ type: "text",
123
+ text: results.length === 0
124
+ ? "No sensors in alert state."
125
+ : JSON.stringify(transformDates(results), null, 2),
126
+ },
127
+ ],
128
+ };
129
+ });
130
+ }
131
+ //# sourceMappingURL=sensors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sensors.js","sourceRoot":"","sources":["../../src/tools/sensors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { PrtgClient } from "../client.js";
3
+ export declare function registerSystemTools(server: McpServer, client: PrtgClient): void;
4
+ //# sourceMappingURL=system.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc/C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA0D/E"}
@@ -0,0 +1,56 @@
1
+ import { transformDates } from "../tz.js";
2
+ function countByStatus(items) {
3
+ const map = {};
4
+ for (const item of items) {
5
+ map[item.status] = (map[item.status] ?? 0) + 1;
6
+ }
7
+ return map;
8
+ }
9
+ export function registerSystemTools(server, client) {
10
+ server.registerTool("get_statistics", {
11
+ title: "Get PRTG Statistics",
12
+ description: "Returns aggregated counts of sensors, devices, and groups broken down by status. " +
13
+ "Useful for a quick health overview of the entire PRTG installation.",
14
+ inputSchema: {},
15
+ }, async () => {
16
+ const [sensors, devices, groups] = await Promise.all([
17
+ client.getAll("/api/v2/experimental/sensors", {
18
+ filter: "type = sensor",
19
+ }),
20
+ client.getAll("/api/v2/experimental/devices", {
21
+ filter: "type = device",
22
+ }),
23
+ client.getAll("/api/v2/experimental/groups", {
24
+ filter: "type = group",
25
+ }),
26
+ ]);
27
+ const stats = {
28
+ sensors: {
29
+ total: sensors.length,
30
+ by_status: countByStatus(sensors),
31
+ },
32
+ devices: {
33
+ total: devices.length,
34
+ by_status: countByStatus(devices),
35
+ },
36
+ groups: {
37
+ total: groups.length,
38
+ by_status: countByStatus(groups),
39
+ },
40
+ };
41
+ return {
42
+ content: [{ type: "text", text: JSON.stringify(stats, null, 2) }],
43
+ };
44
+ });
45
+ server.registerTool("get_license", {
46
+ title: "Get PRTG License",
47
+ description: "Returns PRTG license information: edition, sensor limits, expiry date.",
48
+ inputSchema: {},
49
+ }, async () => {
50
+ const license = await client.get("/api/v2/experimental/license");
51
+ return {
52
+ content: [{ type: "text", text: JSON.stringify(transformDates(license), null, 2) }],
53
+ };
54
+ });
55
+ }
56
+ //# sourceMappingURL=system.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI1C,SAAS,aAAa,CAAC,KAAgC;IACrD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAkB;IACvE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,mFAAmF;YACnF,qEAAqE;QACvE,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnD,MAAM,CAAC,MAAM,CAAS,8BAA8B,EAAE;gBACpD,MAAM,EAAE,eAAe;aACxB,CAAC;YACF,MAAM,CAAC,MAAM,CAAS,8BAA8B,EAAE;gBACpD,MAAM,EAAE,eAAe;aACxB,CAAC;YACF,MAAM,CAAC,MAAM,CAAQ,6BAA6B,EAAE;gBAClD,MAAM,EAAE,cAAc;aACvB,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE;gBACP,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;aAClC;YACD,OAAO,EAAE;gBACP,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;aAClC;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,CAAC,MAAM;gBACpB,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC;aACjC;SACF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,wEAAwE;QACrF,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,8BAA8B,CAAC,CAAC;QAC1E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACpF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}