@teamnetwork-nz/prtg-mcp-server 1.3.0 → 1.5.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.
- package/README.md +14 -2
- package/dist/client.d.ts +11 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +80 -32
- package/dist/client.js.map +1 -1
- package/dist/http-server.d.ts +14 -0
- package/dist/http-server.d.ts.map +1 -0
- package/dist/http-server.js +115 -0
- package/dist/http-server.js.map +1 -0
- package/dist/index.js +49 -62
- package/dist/index.js.map +1 -1
- package/dist/tools/system.d.ts.map +1 -1
- package/dist/tools/system.js +3 -9
- package/dist/tools/system.js.map +1 -1
- package/package.json +12 -3
package/README.md
CHANGED
|
@@ -40,10 +40,15 @@ Set these environment variables before starting the server:
|
|
|
40
40
|
|---|---|---|
|
|
41
41
|
| `PRTG_READWRITE` | `false` | Set to `true` to enable write tools (pause, resume, acknowledge) |
|
|
42
42
|
| `PRTG_IGNORE_SSL` | `false` | Set to `true` to skip TLS verification (self-signed certs) |
|
|
43
|
+
| `PRTG_AUTH_MODE` | `bearer` | Auth method: `bearer` (default, `Authorization: Bearer`) or `query` (`?apitoken=` query parameter) |
|
|
43
44
|
| `PRTG_TZ` | `local` | Timezone for date input/output — see [Timezone handling](#timezone-handling) below |
|
|
44
45
|
| `PRTG_TRANSPORT` | `stdio` | Transport mode: `stdio` (default, local) or `http` (remote agent hosting) |
|
|
45
46
|
| `PRTG_HTTP_PORT` | `3000` | Port to listen on when `PRTG_TRANSPORT=http` |
|
|
46
|
-
| `PRTG_HTTP_HOST` | `
|
|
47
|
+
| `PRTG_HTTP_HOST` | `127.0.0.1` | Bind address when `PRTG_TRANSPORT=http` |
|
|
48
|
+
| `PRTG_HTTP_BEARER_TOKEN` | unset | Token required in `Authorization: Bearer ...`; mandatory for non-loopback binding |
|
|
49
|
+
| `PRTG_HTTP_ALLOWED_HOSTS` | unset | Comma-separated allowed `Host` header values; mandatory for non-loopback binding |
|
|
50
|
+
| `PRTG_HTTP_ALLOWED_ORIGINS` | unset | Comma-separated browser origins permitted to call `/mcp` |
|
|
51
|
+
| `PRTG_HTTP_MAX_BODY_BYTES` | `1048576` | Maximum HTTP request body size |
|
|
47
52
|
|
|
48
53
|
## Timezone handling
|
|
49
54
|
|
|
@@ -99,10 +104,13 @@ PRTG_BASE_URL=https://prtg.example.com:1616 \
|
|
|
99
104
|
PRTG_API_KEY=your-api-key \
|
|
100
105
|
PRTG_TRANSPORT=http \
|
|
101
106
|
PRTG_HTTP_PORT=3000 \
|
|
107
|
+
PRTG_HTTP_BEARER_TOKEN=replace-with-a-long-random-secret \
|
|
102
108
|
PRTG_TZ=Pacific/Auckland \
|
|
103
109
|
node dist/index.js
|
|
104
110
|
```
|
|
105
111
|
|
|
112
|
+
The listener defaults to loopback. To expose it directly or from a container, set `PRTG_HTTP_HOST=0.0.0.0`, `PRTG_HTTP_BEARER_TOKEN`, and `PRTG_HTTP_ALLOWED_HOSTS` (including the port when one appears in the request's `Host` header). TLS should be terminated by a trusted reverse proxy.
|
|
113
|
+
|
|
106
114
|
### Docker
|
|
107
115
|
|
|
108
116
|
```dockerfile
|
|
@@ -113,6 +121,7 @@ RUN npm ci --omit=dev
|
|
|
113
121
|
COPY dist/ ./dist/
|
|
114
122
|
ENV PRTG_TRANSPORT=http
|
|
115
123
|
ENV PRTG_HTTP_PORT=3000
|
|
124
|
+
ENV PRTG_HTTP_HOST=0.0.0.0
|
|
116
125
|
EXPOSE 3000
|
|
117
126
|
CMD ["node", "dist/index.js"]
|
|
118
127
|
```
|
|
@@ -123,6 +132,8 @@ docker build -t prtg-mcp-server .
|
|
|
123
132
|
docker run -p 3000:3000 \
|
|
124
133
|
-e PRTG_BASE_URL=https://prtg.example.com:1616 \
|
|
125
134
|
-e PRTG_API_KEY=your-api-key \
|
|
135
|
+
-e PRTG_HTTP_BEARER_TOKEN=replace-with-a-long-random-secret \
|
|
136
|
+
-e PRTG_HTTP_ALLOWED_HOSTS=your-host:3000 \
|
|
126
137
|
-e PRTG_TZ=Pacific/Auckland \
|
|
127
138
|
prtg-mcp-server
|
|
128
139
|
```
|
|
@@ -134,7 +145,8 @@ docker run -p 3000:3000 \
|
|
|
134
145
|
"mcpServers": {
|
|
135
146
|
"prtg": {
|
|
136
147
|
"type": "http",
|
|
137
|
-
"url": "https://your-host:3000/mcp"
|
|
148
|
+
"url": "https://your-host:3000/mcp",
|
|
149
|
+
"headers": { "Authorization": "Bearer replace-with-a-long-random-secret" }
|
|
138
150
|
}
|
|
139
151
|
}
|
|
140
152
|
}
|
package/dist/client.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export interface ClientConfig {
|
|
2
2
|
baseUrl: string;
|
|
3
3
|
apiKey: string;
|
|
4
|
+
authMode: "bearer" | "query";
|
|
4
5
|
ignoreSsl: boolean;
|
|
5
6
|
}
|
|
6
7
|
export declare class PrtgApiError extends Error {
|
|
@@ -10,10 +11,20 @@ export declare class PrtgApiError extends Error {
|
|
|
10
11
|
}
|
|
11
12
|
export declare class PrtgClient {
|
|
12
13
|
private readonly baseUrl;
|
|
14
|
+
private readonly apiKey;
|
|
15
|
+
private readonly authMode;
|
|
13
16
|
private readonly headers;
|
|
14
17
|
private readonly agent;
|
|
15
18
|
constructor(config: ClientConfig);
|
|
16
19
|
private fetchOptions;
|
|
20
|
+
private applyAuth;
|
|
21
|
+
private buildUrl;
|
|
22
|
+
/** Lightweight connectivity + auth check. Does not throw — returns a result object. */
|
|
23
|
+
ping(): Promise<{
|
|
24
|
+
ok: boolean;
|
|
25
|
+
status: number;
|
|
26
|
+
message: string;
|
|
27
|
+
}>;
|
|
17
28
|
get<T>(path: string, params?: Record<string, string>): Promise<T>;
|
|
18
29
|
patch<T>(path: string, body: unknown): Promise<T>;
|
|
19
30
|
/**
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,YAAa,SAAQ,KAAK;aAEnB,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBADhB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM;CAKlB;AAkBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAM;gBAEhB,MAAM,EAAE,YAAY;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,YAAa,SAAQ,KAAK;aAEnB,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBADhB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM;CAKlB;AAkBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAM;gBAEhB,MAAM,EAAE,YAAY;IAahC,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IAShB,uFAAuF;IACjF,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBjE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BrE,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAkCvD;;;OAGG;IACG,MAAM,CAAC,CAAC,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,QAAQ,SAAM,GACb,OAAO,CAAC,CAAC,EAAE,CAAC;CA2ChB;AAED,wBAAgB,YAAY,IAAI,UAAU,CAoBzC"}
|
package/dist/client.js
CHANGED
|
@@ -17,7 +17,7 @@ function buildActionMessage(statusCode, prtgCode) {
|
|
|
17
17
|
return "Access denied. The API key may lack the required permissions on this PRTG object.";
|
|
18
18
|
}
|
|
19
19
|
if (statusCode === 404) {
|
|
20
|
-
return "Resource not found. The object ID may be incorrect
|
|
20
|
+
return "Resource not found. The object ID may be incorrect, the object may have been deleted, or the v2 API endpoint is not supported on this PRTG version (requires 25.1.102.1373+).";
|
|
21
21
|
}
|
|
22
22
|
if (statusCode === 503 || statusCode === 502) {
|
|
23
23
|
return "PRTG core is unavailable. Check that the PRTG service is running.";
|
|
@@ -26,16 +26,19 @@ function buildActionMessage(statusCode, prtgCode) {
|
|
|
26
26
|
}
|
|
27
27
|
export class PrtgClient {
|
|
28
28
|
baseUrl;
|
|
29
|
+
apiKey;
|
|
30
|
+
authMode;
|
|
29
31
|
headers;
|
|
30
32
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
31
33
|
agent;
|
|
32
34
|
constructor(config) {
|
|
33
35
|
this.baseUrl = config.baseUrl.replace(/\/$/, "");
|
|
34
|
-
this.
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
36
|
+
this.apiKey = config.apiKey;
|
|
37
|
+
this.authMode = config.authMode;
|
|
38
|
+
this.headers =
|
|
39
|
+
config.authMode === "bearer"
|
|
40
|
+
? { Authorization: `Bearer ${config.apiKey}`, Accept: "application/json", "Content-Type": "application/json" }
|
|
41
|
+
: { Accept: "application/json", "Content-Type": "application/json" };
|
|
39
42
|
if (config.ignoreSsl) {
|
|
40
43
|
this.agent = new https.Agent({ rejectUnauthorized: false });
|
|
41
44
|
}
|
|
@@ -47,13 +50,54 @@ export class PrtgClient {
|
|
|
47
50
|
...extra,
|
|
48
51
|
};
|
|
49
52
|
}
|
|
50
|
-
|
|
53
|
+
applyAuth(url) {
|
|
54
|
+
if (this.authMode === "query") {
|
|
55
|
+
url.searchParams.set("apitoken", this.apiKey);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
buildUrl(path, params = {}) {
|
|
51
59
|
const url = new URL(`${this.baseUrl}${path}`);
|
|
52
60
|
for (const [k, v] of Object.entries(params)) {
|
|
53
61
|
if (v !== undefined && v !== "")
|
|
54
62
|
url.searchParams.set(k, v);
|
|
55
63
|
}
|
|
56
|
-
|
|
64
|
+
this.applyAuth(url);
|
|
65
|
+
return url;
|
|
66
|
+
}
|
|
67
|
+
/** Lightweight connectivity + auth check. Does not throw — returns a result object. */
|
|
68
|
+
async ping() {
|
|
69
|
+
const url = this.buildUrl("/api/v2/experimental/probes", { limit: "1" });
|
|
70
|
+
try {
|
|
71
|
+
const res = await fetch(url.toString(), this.fetchOptions());
|
|
72
|
+
if (res.ok) {
|
|
73
|
+
return { ok: true, status: res.status, message: "OK" };
|
|
74
|
+
}
|
|
75
|
+
let prtgMessage = res.statusText;
|
|
76
|
+
try {
|
|
77
|
+
const body = (await res.json());
|
|
78
|
+
if (body.message)
|
|
79
|
+
prtgMessage = body.message;
|
|
80
|
+
}
|
|
81
|
+
catch { /* non-JSON */ }
|
|
82
|
+
return { ok: false, status: res.status, message: prtgMessage };
|
|
83
|
+
}
|
|
84
|
+
catch (err) {
|
|
85
|
+
const cause = err.cause;
|
|
86
|
+
const detail = cause?.message ?? err.message;
|
|
87
|
+
return { ok: false, status: 0, message: `Network error: ${detail}` };
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
async get(path, params = {}) {
|
|
91
|
+
const url = this.buildUrl(path, params);
|
|
92
|
+
let res;
|
|
93
|
+
try {
|
|
94
|
+
res = await fetch(url.toString(), this.fetchOptions());
|
|
95
|
+
}
|
|
96
|
+
catch (err) {
|
|
97
|
+
const cause = err.cause;
|
|
98
|
+
const detail = cause?.message ?? err.message;
|
|
99
|
+
throw new Error(`Network error reaching PRTG: ${detail}`);
|
|
100
|
+
}
|
|
57
101
|
if (!res.ok) {
|
|
58
102
|
let prtgCode = "UNKNOWN";
|
|
59
103
|
let prtgMessage = res.statusText;
|
|
@@ -62,18 +106,22 @@ export class PrtgClient {
|
|
|
62
106
|
prtgCode = body.code ?? prtgCode;
|
|
63
107
|
prtgMessage = body.message ?? prtgMessage;
|
|
64
108
|
}
|
|
65
|
-
catch {
|
|
66
|
-
// non-JSON error body
|
|
67
|
-
}
|
|
109
|
+
catch { /* non-JSON error body */ }
|
|
68
110
|
throw new PrtgApiError(res.status, prtgCode, buildActionMessage(res.status, prtgCode) + ` Detail: ${prtgMessage}`);
|
|
69
111
|
}
|
|
70
112
|
return res.json();
|
|
71
113
|
}
|
|
72
114
|
async patch(path, body) {
|
|
73
|
-
const
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
115
|
+
const url = this.buildUrl(path);
|
|
116
|
+
let res;
|
|
117
|
+
try {
|
|
118
|
+
res = await fetch(url.toString(), this.fetchOptions({ method: "PATCH", body: JSON.stringify(body) }));
|
|
119
|
+
}
|
|
120
|
+
catch (err) {
|
|
121
|
+
const cause = err.cause;
|
|
122
|
+
const detail = cause?.message ?? err.message;
|
|
123
|
+
throw new Error(`Network error reaching PRTG: ${detail}`);
|
|
124
|
+
}
|
|
77
125
|
if (!res.ok) {
|
|
78
126
|
let prtgCode = "UNKNOWN";
|
|
79
127
|
let prtgMessage = res.statusText;
|
|
@@ -82,9 +130,7 @@ export class PrtgClient {
|
|
|
82
130
|
prtgCode = b.code ?? prtgCode;
|
|
83
131
|
prtgMessage = b.message ?? prtgMessage;
|
|
84
132
|
}
|
|
85
|
-
catch {
|
|
86
|
-
// non-JSON error body
|
|
87
|
-
}
|
|
133
|
+
catch { /* non-JSON error body */ }
|
|
88
134
|
throw new PrtgApiError(res.status, prtgCode, buildActionMessage(res.status, prtgCode) + ` Detail: ${prtgMessage}`);
|
|
89
135
|
}
|
|
90
136
|
// 204 No Content is a valid success for PATCH
|
|
@@ -100,16 +146,18 @@ export class PrtgClient {
|
|
|
100
146
|
const results = [];
|
|
101
147
|
let offset = 0;
|
|
102
148
|
while (true) {
|
|
103
|
-
const
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
149
|
+
const url = this.buildUrl(path, params);
|
|
150
|
+
url.searchParams.set("limit", String(pageSize));
|
|
151
|
+
url.searchParams.set("offset", String(offset));
|
|
152
|
+
let res;
|
|
153
|
+
try {
|
|
154
|
+
res = await fetch(url.toString(), this.fetchOptions());
|
|
155
|
+
}
|
|
156
|
+
catch (err) {
|
|
157
|
+
const cause = err.cause;
|
|
158
|
+
const detail = cause?.message ?? err.message;
|
|
159
|
+
throw new Error(`Network error reaching PRTG: ${detail}`);
|
|
160
|
+
}
|
|
113
161
|
if (!res.ok) {
|
|
114
162
|
let prtgCode = "UNKNOWN";
|
|
115
163
|
let prtgMessage = res.statusText;
|
|
@@ -118,9 +166,7 @@ export class PrtgClient {
|
|
|
118
166
|
prtgCode = b.code ?? prtgCode;
|
|
119
167
|
prtgMessage = b.message ?? prtgMessage;
|
|
120
168
|
}
|
|
121
|
-
catch {
|
|
122
|
-
// non-JSON error body
|
|
123
|
-
}
|
|
169
|
+
catch { /* non-JSON error body */ }
|
|
124
170
|
throw new PrtgApiError(res.status, prtgCode, buildActionMessage(res.status, prtgCode) + ` Detail: ${prtgMessage}`);
|
|
125
171
|
}
|
|
126
172
|
const total = parseInt(res.headers.get("X-Total-Count") ?? "0", 10);
|
|
@@ -137,14 +183,16 @@ export function createClient() {
|
|
|
137
183
|
const baseUrl = process.env["PRTG_BASE_URL"];
|
|
138
184
|
const apiKey = process.env["PRTG_API_KEY"];
|
|
139
185
|
const ignoreSsl = process.env["PRTG_IGNORE_SSL"] === "true";
|
|
186
|
+
const authModeRaw = (process.env["PRTG_AUTH_MODE"] ?? "bearer").toLowerCase();
|
|
140
187
|
if (!baseUrl)
|
|
141
188
|
throw new Error("PRTG_BASE_URL environment variable is required.");
|
|
142
189
|
if (!apiKey)
|
|
143
190
|
throw new Error("PRTG_API_KEY environment variable is required.");
|
|
191
|
+
const authMode = authModeRaw === "query" ? "query" : "bearer";
|
|
144
192
|
if (ignoreSsl) {
|
|
145
193
|
process.stderr.write("[prtg-mcp] WARNING: SSL verification disabled (PRTG_IGNORE_SSL=true)\n");
|
|
146
194
|
process.env["NODE_TLS_REJECT_UNAUTHORIZED"] = "0";
|
|
147
195
|
}
|
|
148
|
-
return new PrtgClient({ baseUrl, apiKey, ignoreSsl });
|
|
196
|
+
return new PrtgClient({ baseUrl, apiKey, authMode, ignoreSsl });
|
|
149
197
|
}
|
|
150
198
|
//# sourceMappingURL=client.js.map
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import http from "node:http";
|
|
2
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
3
|
+
export interface HttpServerOptions {
|
|
4
|
+
host: string;
|
|
5
|
+
port: number;
|
|
6
|
+
serverName: string;
|
|
7
|
+
bearerToken?: string;
|
|
8
|
+
allowedHosts?: string[];
|
|
9
|
+
allowedOrigins?: string[];
|
|
10
|
+
maxBodyBytes?: number;
|
|
11
|
+
}
|
|
12
|
+
export declare function validateHttpOptions(options: HttpServerOptions): void;
|
|
13
|
+
export declare function createHttpTransportServer(createServer: () => McpServer, options: HttpServerOptions): http.Server;
|
|
14
|
+
//# sourceMappingURL=http-server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgDD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAapE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,SAAS,EAC7B,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAAC,MAAM,CAuDb"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { timingSafeEqual } from "node:crypto";
|
|
2
|
+
import http from "node:http";
|
|
3
|
+
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
|
|
4
|
+
const LOOPBACK_HOSTS = new Set(["127.0.0.1", "::1", "localhost"]);
|
|
5
|
+
function json(res, status, body) {
|
|
6
|
+
res.writeHead(status, { "Content-Type": "application/json" });
|
|
7
|
+
res.end(JSON.stringify(body));
|
|
8
|
+
}
|
|
9
|
+
function rpcError(res, status, code, message) {
|
|
10
|
+
json(res, status, { jsonrpc: "2.0", error: { code, message }, id: null });
|
|
11
|
+
}
|
|
12
|
+
function tokenMatches(header, expected) {
|
|
13
|
+
if (!header?.startsWith("Bearer "))
|
|
14
|
+
return false;
|
|
15
|
+
const supplied = Buffer.from(header.slice(7));
|
|
16
|
+
const wanted = Buffer.from(expected);
|
|
17
|
+
return supplied.length === wanted.length && timingSafeEqual(supplied, wanted);
|
|
18
|
+
}
|
|
19
|
+
async function readJsonBody(req, limit) {
|
|
20
|
+
return new Promise((resolve, reject) => {
|
|
21
|
+
const chunks = [];
|
|
22
|
+
let size = 0;
|
|
23
|
+
let tooLarge = false;
|
|
24
|
+
req.on("data", (chunk) => {
|
|
25
|
+
size += chunk.length;
|
|
26
|
+
if (size > limit) {
|
|
27
|
+
tooLarge = true;
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
chunks.push(chunk);
|
|
31
|
+
});
|
|
32
|
+
req.on("end", () => {
|
|
33
|
+
if (tooLarge) {
|
|
34
|
+
reject(Object.assign(new Error("Request body too large"), { statusCode: 413 }));
|
|
35
|
+
return;
|
|
36
|
+
}
|
|
37
|
+
try {
|
|
38
|
+
resolve(JSON.parse(Buffer.concat(chunks).toString("utf8")));
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
reject(Object.assign(new Error("Invalid JSON body"), { statusCode: 400 }));
|
|
42
|
+
}
|
|
43
|
+
});
|
|
44
|
+
req.on("error", reject);
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
export function validateHttpOptions(options) {
|
|
48
|
+
if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65535) {
|
|
49
|
+
throw new Error(`Invalid HTTP port: ${options.port}`);
|
|
50
|
+
}
|
|
51
|
+
if (options.maxBodyBytes !== undefined && (!Number.isInteger(options.maxBodyBytes) || options.maxBodyBytes < 1)) {
|
|
52
|
+
throw new Error(`Invalid HTTP body limit: ${options.maxBodyBytes}`);
|
|
53
|
+
}
|
|
54
|
+
if (!LOOPBACK_HOSTS.has(options.host) && !options.bearerToken) {
|
|
55
|
+
throw new Error("A bearer token is required when the HTTP server binds beyond loopback");
|
|
56
|
+
}
|
|
57
|
+
if (!LOOPBACK_HOSTS.has(options.host) && !options.allowedHosts?.length) {
|
|
58
|
+
throw new Error("HTTP_ALLOWED_HOSTS is required when the HTTP server binds beyond loopback");
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
export function createHttpTransportServer(createServer, options) {
|
|
62
|
+
validateHttpOptions(options);
|
|
63
|
+
const allowedHosts = new Set(options.allowedHosts?.map((value) => value.toLowerCase()));
|
|
64
|
+
const allowedOrigins = new Set(options.allowedOrigins?.map((value) => value.toLowerCase()));
|
|
65
|
+
const maxBodyBytes = options.maxBodyBytes ?? 1024 * 1024;
|
|
66
|
+
return http.createServer(async (req, res) => {
|
|
67
|
+
const url = new URL(req.url ?? "/", "http://localhost");
|
|
68
|
+
if (url.pathname === "/health") {
|
|
69
|
+
json(res, 200, { status: "ok", server: options.serverName });
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
if (url.pathname !== "/mcp") {
|
|
73
|
+
res.writeHead(404).end();
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
if (allowedHosts.size && !allowedHosts.has((req.headers.host ?? "").toLowerCase())) {
|
|
77
|
+
rpcError(res, 403, -32000, "Host not allowed");
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
if (req.headers.origin && !allowedOrigins.has(req.headers.origin.toLowerCase())) {
|
|
81
|
+
rpcError(res, 403, -32000, "Origin not allowed");
|
|
82
|
+
return;
|
|
83
|
+
}
|
|
84
|
+
if (options.bearerToken && !tokenMatches(req.headers.authorization, options.bearerToken)) {
|
|
85
|
+
res.setHeader("WWW-Authenticate", "Bearer");
|
|
86
|
+
rpcError(res, 401, -32001, "Unauthorized");
|
|
87
|
+
return;
|
|
88
|
+
}
|
|
89
|
+
if (req.method !== "POST") {
|
|
90
|
+
res.setHeader("Allow", "POST");
|
|
91
|
+
rpcError(res, 405, -32000, "Method not allowed");
|
|
92
|
+
return;
|
|
93
|
+
}
|
|
94
|
+
const server = createServer();
|
|
95
|
+
const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
|
|
96
|
+
try {
|
|
97
|
+
const body = await readJsonBody(req, maxBodyBytes);
|
|
98
|
+
await server.connect(transport);
|
|
99
|
+
await transport.handleRequest(req, res, body);
|
|
100
|
+
res.once("close", () => {
|
|
101
|
+
void transport.close();
|
|
102
|
+
void server.close();
|
|
103
|
+
});
|
|
104
|
+
}
|
|
105
|
+
catch (error) {
|
|
106
|
+
void transport.close();
|
|
107
|
+
void server.close();
|
|
108
|
+
if (!res.headersSent) {
|
|
109
|
+
const status = error.statusCode ?? 500;
|
|
110
|
+
rpcError(res, status, status === 400 ? -32700 : -32603, status < 500 ? error.message : "Internal server error");
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=http-server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import http from "node:http";
|
|
3
2
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
4
3
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
5
|
-
import {
|
|
4
|
+
import { createHttpTransportServer } from "./http-server.js";
|
|
6
5
|
import { createClient } from "./client.js";
|
|
7
6
|
import { registerSensorTools } from "./tools/sensors.js";
|
|
8
7
|
import { registerDeviceTools } from "./tools/devices.js";
|
|
@@ -11,21 +10,6 @@ import { registerMetricsTools } from "./tools/metrics.js";
|
|
|
11
10
|
import { registerSystemTools } from "./tools/system.js";
|
|
12
11
|
import { registerActionTools } from "./tools/actions.js";
|
|
13
12
|
import { getEffectiveTz } from "./tz.js";
|
|
14
|
-
async function readJsonBody(req) {
|
|
15
|
-
return new Promise((resolve, reject) => {
|
|
16
|
-
const chunks = [];
|
|
17
|
-
req.on("data", (chunk) => chunks.push(chunk));
|
|
18
|
-
req.on("end", () => {
|
|
19
|
-
try {
|
|
20
|
-
resolve(JSON.parse(Buffer.concat(chunks).toString()));
|
|
21
|
-
}
|
|
22
|
-
catch {
|
|
23
|
-
resolve(undefined);
|
|
24
|
-
}
|
|
25
|
-
});
|
|
26
|
-
req.on("error", reject);
|
|
27
|
-
});
|
|
28
|
-
}
|
|
29
13
|
async function main() {
|
|
30
14
|
let client;
|
|
31
15
|
try {
|
|
@@ -45,18 +29,41 @@ async function main() {
|
|
|
45
29
|
}
|
|
46
30
|
const readwrite = process.env["PRTG_READWRITE"] === "true";
|
|
47
31
|
const transportMode = process.env["PRTG_TRANSPORT"] ?? "stdio";
|
|
32
|
+
const authMode = (process.env["PRTG_AUTH_MODE"] ?? "bearer").toLowerCase() === "query" ? "query" : "bearer";
|
|
48
33
|
process.stderr.write(`[prtg-mcp] Timezone: ${tz}\n`);
|
|
34
|
+
process.stderr.write(`[prtg-mcp] Auth mode: ${authMode}\n`);
|
|
35
|
+
// Startup connectivity check — warn early rather than failing silently on first tool call
|
|
36
|
+
const ping = await client.ping();
|
|
37
|
+
if (ping.ok) {
|
|
38
|
+
process.stderr.write(`[prtg-mcp] Connected to PRTG at ${process.env["PRTG_BASE_URL"]}\n`);
|
|
39
|
+
}
|
|
40
|
+
else if (ping.status === 401 || ping.status === 403) {
|
|
41
|
+
process.stderr.write(`[prtg-mcp] WARNING: PRTG auth check failed (HTTP ${ping.status}). ` +
|
|
42
|
+
`Verify PRTG_API_KEY is a valid v2 API key generated via PRTG → My Account → API Keys. ` +
|
|
43
|
+
`If your PRTG uses token query-param auth, set PRTG_AUTH_MODE=query.\n`);
|
|
44
|
+
}
|
|
45
|
+
else if (ping.status === 404) {
|
|
46
|
+
process.stderr.write(`[prtg-mcp] WARNING: PRTG v2 API not found at ${process.env["PRTG_BASE_URL"]} (HTTP 404). ` +
|
|
47
|
+
`Check PRTG_BASE_URL and confirm your PRTG version is 25.1.102.1373 or newer.\n`);
|
|
48
|
+
}
|
|
49
|
+
else if (ping.status === 0) {
|
|
50
|
+
process.stderr.write(`[prtg-mcp] WARNING: Could not reach PRTG — ${ping.message}\n`);
|
|
51
|
+
}
|
|
52
|
+
else {
|
|
53
|
+
process.stderr.write(`[prtg-mcp] WARNING: Unexpected response from PRTG during startup check (HTTP ${ping.status}): ${ping.message}\n`);
|
|
54
|
+
}
|
|
49
55
|
if (readwrite) {
|
|
50
56
|
process.stderr.write("[prtg-mcp] Running in read-write mode (write tools enabled)\n");
|
|
51
57
|
}
|
|
52
58
|
else {
|
|
53
59
|
process.stderr.write("[prtg-mcp] Running in read-only mode (set PRTG_READWRITE=true to enable write tools)\n");
|
|
54
60
|
}
|
|
55
|
-
const
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
61
|
+
const createConfiguredServer = () => {
|
|
62
|
+
const server = new McpServer({
|
|
63
|
+
name: "@teamnetwork/prtg-mcp-server",
|
|
64
|
+
version: "1.5.0",
|
|
65
|
+
}, {
|
|
66
|
+
instructions: `
|
|
60
67
|
PRTG Network Monitor MCP server — monitoring data via the PRTG v2 REST API.
|
|
61
68
|
|
|
62
69
|
## Mode
|
|
@@ -91,54 +98,34 @@ PRTG Network Monitor MCP server — monitoring data via the PRTG v2 REST API.
|
|
|
91
98
|
- All tools use PRTG numeric object IDs. These appear as "id" in list results.
|
|
92
99
|
- Use search or get_hierarchy to discover IDs before calling get_sensor, get_channels, or the write tools.
|
|
93
100
|
`.trim(),
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
101
|
+
});
|
|
102
|
+
registerSensorTools(server, client);
|
|
103
|
+
registerDeviceTools(server, client);
|
|
104
|
+
registerNavigationTools(server, client);
|
|
105
|
+
registerMetricsTools(server, client);
|
|
106
|
+
registerSystemTools(server, client);
|
|
107
|
+
if (readwrite)
|
|
108
|
+
registerActionTools(server, client);
|
|
109
|
+
return server;
|
|
110
|
+
};
|
|
102
111
|
if (transportMode === "http") {
|
|
103
112
|
const port = parseInt(process.env["PRTG_HTTP_PORT"] ?? "3000", 10);
|
|
104
|
-
const host = process.env["PRTG_HTTP_HOST"] ?? "
|
|
105
|
-
const
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
res.end(JSON.stringify({ status: "ok", server: "@teamnetwork/prtg-mcp-server" }));
|
|
114
|
-
return;
|
|
115
|
-
}
|
|
116
|
-
if (!url.startsWith("/mcp")) {
|
|
117
|
-
res.writeHead(404);
|
|
118
|
-
res.end();
|
|
119
|
-
return;
|
|
120
|
-
}
|
|
121
|
-
try {
|
|
122
|
-
if (req.method === "POST") {
|
|
123
|
-
const body = await readJsonBody(req);
|
|
124
|
-
await transport.handleRequest(req, res, body);
|
|
125
|
-
}
|
|
126
|
-
else {
|
|
127
|
-
await transport.handleRequest(req, res);
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
catch (err) {
|
|
131
|
-
if (!res.headersSent) {
|
|
132
|
-
res.writeHead(500, { "Content-Type": "application/json" });
|
|
133
|
-
res.end(JSON.stringify({ error: err.message }));
|
|
134
|
-
}
|
|
135
|
-
}
|
|
113
|
+
const host = process.env["PRTG_HTTP_HOST"] ?? "127.0.0.1";
|
|
114
|
+
const httpServer = createHttpTransportServer(createConfiguredServer, {
|
|
115
|
+
host,
|
|
116
|
+
port,
|
|
117
|
+
serverName: "@teamnetwork/prtg-mcp-server",
|
|
118
|
+
bearerToken: process.env["PRTG_HTTP_BEARER_TOKEN"],
|
|
119
|
+
allowedHosts: process.env["PRTG_HTTP_ALLOWED_HOSTS"]?.split(",").map((value) => value.trim()).filter(Boolean),
|
|
120
|
+
allowedOrigins: process.env["PRTG_HTTP_ALLOWED_ORIGINS"]?.split(",").map((value) => value.trim()).filter(Boolean),
|
|
121
|
+
maxBodyBytes: parseInt(process.env["PRTG_HTTP_MAX_BODY_BYTES"] ?? "1048576", 10),
|
|
136
122
|
});
|
|
137
123
|
httpServer.listen(port, host, () => {
|
|
138
124
|
process.stderr.write(`[prtg-mcp] HTTP transport listening on ${host}:${port}/mcp\n`);
|
|
139
125
|
});
|
|
140
126
|
}
|
|
141
127
|
else {
|
|
128
|
+
const server = createConfiguredServer();
|
|
142
129
|
const transport = new StdioServerTransport();
|
|
143
130
|
await server.connect(transport);
|
|
144
131
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,KAAK,UAAU,IAAI;IACjB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAoC,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QACH,EAAE,GAAG,cAAc,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAoC,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC;IAC/D,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE5G,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,QAAQ,IAAI,CAAC,CAAC;IAE5D,0FAA0F;IAC1F,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5F,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oDAAoD,IAAI,CAAC,MAAM,KAAK;YACpE,wFAAwF;YACxF,uEAAuE,CACxE,CAAC;IACJ,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gDAAgD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,eAAe;YAC3F,gFAAgF,CACjF,CAAC;IACJ,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACvF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gFAAgF,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,OAAO,IAAI,CAClH,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,sBAAsB,GAAG,GAAc,EAAE;QAC7C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC5B;YACE,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,OAAO;SACjB,EACD;YACE,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCb,CAAC,IAAI,EAAE;SACT,CACF,CAAC;QAEA,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,SAAS;YAAE,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,WAAW,CAAC;QAC1D,MAAM,UAAU,GAAG,yBAAyB,CAAC,sBAAsB,EAAE;YACnE,IAAI;YACJ,IAAI;YACJ,UAAU,EAAE,8BAA8B;YAC1C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;YAClD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAC7G,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACjH,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,SAAS,EAAE,EAAE,CAAC;SACjF,CAAC,CAAC;QAEH,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAsB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -1 +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,
|
|
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,CAoD/E"}
|
package/dist/tools/system.js
CHANGED
|
@@ -14,15 +14,9 @@ export function registerSystemTools(server, client) {
|
|
|
14
14
|
inputSchema: {},
|
|
15
15
|
}, async () => {
|
|
16
16
|
const [sensors, devices, groups] = await Promise.all([
|
|
17
|
-
client.getAll("/api/v2/experimental/sensors", {
|
|
18
|
-
|
|
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
|
-
}),
|
|
17
|
+
client.getAll("/api/v2/experimental/sensors", {}),
|
|
18
|
+
client.getAll("/api/v2/experimental/devices", {}),
|
|
19
|
+
client.getAll("/api/v2/experimental/groups", {}),
|
|
26
20
|
]);
|
|
27
21
|
const stats = {
|
|
28
22
|
sensors: {
|
package/dist/tools/system.js.map
CHANGED
|
@@ -1 +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
|
|
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,EAAE,CAAC;YACzD,MAAM,CAAC,MAAM,CAAS,8BAA8B,EAAE,EAAE,CAAC;YACzD,MAAM,CAAC,MAAM,CAAQ,6BAA6B,EAAE,EAAE,CAAC;SACxD,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"}
|
package/package.json
CHANGED
|
@@ -1,17 +1,26 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@teamnetwork-nz/prtg-mcp-server",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.5.0",
|
|
4
4
|
"description": "MCP server for PRTG Network Monitor — v2 REST API only, no database required",
|
|
5
|
-
"keywords": [
|
|
5
|
+
"keywords": [
|
|
6
|
+
"mcp",
|
|
7
|
+
"prtg",
|
|
8
|
+
"monitoring",
|
|
9
|
+
"network",
|
|
10
|
+
"claude"
|
|
11
|
+
],
|
|
6
12
|
"license": "MIT",
|
|
7
13
|
"type": "module",
|
|
8
14
|
"bin": {
|
|
9
15
|
"prtg-mcp-server": "./dist/index.js"
|
|
10
16
|
},
|
|
11
17
|
"main": "./dist/index.js",
|
|
12
|
-
"files": [
|
|
18
|
+
"files": [
|
|
19
|
+
"dist"
|
|
20
|
+
],
|
|
13
21
|
"scripts": {
|
|
14
22
|
"build": "tsc",
|
|
23
|
+
"test": "npm run build && node --test tests/*.test.mjs",
|
|
15
24
|
"dev": "tsc --watch",
|
|
16
25
|
"start": "node dist/index.js",
|
|
17
26
|
"prepublishOnly": "npm run build"
|