@guckdev/mcp 0.3.1 → 0.4.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/dist/server.d.ts.map +1 -1
- package/dist/server.js +77 -15
- package/dist/server.js.map +1 -1
- package/package.json +2 -2
- package/src/server.ts +78 -14
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA0HA,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,IAAI,CAkKnD,CAAC"}
|
package/dist/server.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
|
|
2
2
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
3
3
|
import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
|
|
4
|
-
import { loadConfig, readCheckpoint, readSearch, readSessions, readStats, readTail, redactEvent, resolveStoreDir, } from "@guckdev/core";
|
|
4
|
+
import { formatEventText, loadConfig, projectEventFields, readCheckpoint, readSearch, readSessions, readStats, readTail, redactEvent, resolveStoreDir, } from "@guckdev/core";
|
|
5
5
|
const SEARCH_SCHEMA = {
|
|
6
6
|
type: "object",
|
|
7
7
|
additionalProperties: false,
|
|
@@ -12,9 +12,13 @@ const SEARCH_SCHEMA = {
|
|
|
12
12
|
types: { type: "array", items: { type: "string" } },
|
|
13
13
|
levels: { type: "array", items: { type: "string" } },
|
|
14
14
|
contains: { type: "string" },
|
|
15
|
+
query: { type: "string" },
|
|
15
16
|
since: { type: "string" },
|
|
16
17
|
until: { type: "string" },
|
|
17
18
|
limit: { type: "number" },
|
|
19
|
+
format: { type: "string", enum: ["json", "text"] },
|
|
20
|
+
fields: { type: "array", items: { type: "string" } },
|
|
21
|
+
template: { type: "string" },
|
|
18
22
|
backends: { type: "array", items: { type: "string" } },
|
|
19
23
|
config_path: { type: "string" },
|
|
20
24
|
},
|
|
@@ -53,6 +57,10 @@ const TAIL_SCHEMA = {
|
|
|
53
57
|
session_id: { type: "string" },
|
|
54
58
|
run_id: { type: "string" },
|
|
55
59
|
limit: { type: "number" },
|
|
60
|
+
query: { type: "string" },
|
|
61
|
+
format: { type: "string", enum: ["json", "text"] },
|
|
62
|
+
fields: { type: "array", items: { type: "string" } },
|
|
63
|
+
template: { type: "string" },
|
|
56
64
|
backends: { type: "array", items: { type: "string" } },
|
|
57
65
|
config_path: { type: "string" },
|
|
58
66
|
},
|
|
@@ -97,7 +105,7 @@ export const startMcpServer = async () => {
|
|
|
97
105
|
tools: [
|
|
98
106
|
{
|
|
99
107
|
name: "guck.search",
|
|
100
|
-
description: "Search telemetry events with filters.",
|
|
108
|
+
description: "Search telemetry events with filters. Supports boolean message-only query (query), JSON field projection (fields), or text formatting with template (format: text + template).",
|
|
101
109
|
inputSchema: SEARCH_SCHEMA,
|
|
102
110
|
},
|
|
103
111
|
{
|
|
@@ -112,7 +120,7 @@ export const startMcpServer = async () => {
|
|
|
112
120
|
},
|
|
113
121
|
{
|
|
114
122
|
name: "guck.tail",
|
|
115
|
-
description: "Return the most recent events (non-streaming).",
|
|
123
|
+
description: "Return the most recent events (non-streaming). Supports message-only boolean query (query) and output formatting (format: json/text, fields, template).",
|
|
116
124
|
inputSchema: TAIL_SCHEMA,
|
|
117
125
|
},
|
|
118
126
|
],
|
|
@@ -135,9 +143,35 @@ export const startMcpServer = async () => {
|
|
|
135
143
|
...filters,
|
|
136
144
|
since: resolveSince(filters.since, config, storeDir),
|
|
137
145
|
};
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
146
|
+
try {
|
|
147
|
+
const result = await readSearch(config, rootDir, withDefaults);
|
|
148
|
+
const redacted = result.events.map((event) => redactEvent(config, event));
|
|
149
|
+
if (input.format === "text") {
|
|
150
|
+
const lines = redacted.map((event) => formatEventText(event, input.template));
|
|
151
|
+
return buildText({
|
|
152
|
+
format: "text",
|
|
153
|
+
lines,
|
|
154
|
+
truncated: result.truncated,
|
|
155
|
+
errors: result.errors,
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
if (input.fields && input.fields.length > 0) {
|
|
159
|
+
const projected = redacted.map((event) => projectEventFields(event, input.fields ?? []));
|
|
160
|
+
return buildText({
|
|
161
|
+
format: "json",
|
|
162
|
+
events: projected,
|
|
163
|
+
truncated: result.truncated,
|
|
164
|
+
errors: result.errors,
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
return buildText({ format: "json", ...result, events: redacted });
|
|
168
|
+
}
|
|
169
|
+
catch (error) {
|
|
170
|
+
if (error instanceof Error && error.message.startsWith("Invalid query:")) {
|
|
171
|
+
return buildText({ error: error.message, query: input.query });
|
|
172
|
+
}
|
|
173
|
+
throw error;
|
|
174
|
+
}
|
|
141
175
|
}
|
|
142
176
|
if (request.params.name === "guck.stats") {
|
|
143
177
|
const input = (request.params.arguments ?? {});
|
|
@@ -164,16 +198,44 @@ export const startMcpServer = async () => {
|
|
|
164
198
|
const { config_path: _configPath, ...filters } = input;
|
|
165
199
|
const limit = input.limit ?? Math.min(config.mcp.max_results, 50);
|
|
166
200
|
const since = resolveSince(undefined, config, storeDir);
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
201
|
+
let result;
|
|
202
|
+
try {
|
|
203
|
+
result = await readTail(config, rootDir, {
|
|
204
|
+
service: filters.service,
|
|
205
|
+
session_id: filters.session_id,
|
|
206
|
+
run_id: filters.run_id,
|
|
207
|
+
query: filters.query,
|
|
208
|
+
limit,
|
|
209
|
+
backends: filters.backends,
|
|
210
|
+
since,
|
|
211
|
+
});
|
|
212
|
+
}
|
|
213
|
+
catch (error) {
|
|
214
|
+
if (error instanceof Error && error.message.startsWith("Invalid query:")) {
|
|
215
|
+
return buildText({ error: error.message, query: input.query });
|
|
216
|
+
}
|
|
217
|
+
throw error;
|
|
218
|
+
}
|
|
175
219
|
const redacted = result.events.map((event) => redactEvent(config, event));
|
|
176
|
-
|
|
220
|
+
if (input.format === "text") {
|
|
221
|
+
const lines = redacted.map((event) => formatEventText(event, input.template));
|
|
222
|
+
return buildText({
|
|
223
|
+
format: "text",
|
|
224
|
+
lines,
|
|
225
|
+
truncated: result.truncated,
|
|
226
|
+
errors: result.errors,
|
|
227
|
+
});
|
|
228
|
+
}
|
|
229
|
+
if (input.fields && input.fields.length > 0) {
|
|
230
|
+
const projected = redacted.map((event) => projectEventFields(event, input.fields ?? []));
|
|
231
|
+
return buildText({
|
|
232
|
+
format: "json",
|
|
233
|
+
events: projected,
|
|
234
|
+
truncated: result.truncated,
|
|
235
|
+
errors: result.errors,
|
|
236
|
+
});
|
|
237
|
+
}
|
|
238
|
+
return buildText({ format: "json", ...result, events: redacted });
|
|
177
239
|
}
|
|
178
240
|
throw new Error(`Unknown tool: ${request.params.name}`);
|
|
179
241
|
});
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@guckdev/mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "MCP server for Guck telemetry",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {
|
|
36
36
|
"@modelcontextprotocol/sdk": "1.26.0",
|
|
37
|
-
"@guckdev/core": "0.
|
|
37
|
+
"@guckdev/core": "0.4.0"
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
40
|
"@types/node": "25.2.2"
|
package/src/server.ts
CHANGED
|
@@ -10,7 +10,9 @@ import {
|
|
|
10
10
|
GuckSessionsParams,
|
|
11
11
|
GuckStatsParams,
|
|
12
12
|
GuckTailParams,
|
|
13
|
+
formatEventText,
|
|
13
14
|
loadConfig,
|
|
15
|
+
projectEventFields,
|
|
14
16
|
readCheckpoint,
|
|
15
17
|
readSearch,
|
|
16
18
|
readSessions,
|
|
@@ -29,9 +31,13 @@ const SEARCH_SCHEMA = {
|
|
|
29
31
|
types: { type: "array", items: { type: "string" } },
|
|
30
32
|
levels: { type: "array", items: { type: "string" } },
|
|
31
33
|
contains: { type: "string" },
|
|
34
|
+
query: { type: "string" },
|
|
32
35
|
since: { type: "string" },
|
|
33
36
|
until: { type: "string" },
|
|
34
37
|
limit: { type: "number" },
|
|
38
|
+
format: { type: "string", enum: ["json", "text"] },
|
|
39
|
+
fields: { type: "array", items: { type: "string" } },
|
|
40
|
+
template: { type: "string" },
|
|
35
41
|
backends: { type: "array", items: { type: "string" } },
|
|
36
42
|
config_path: { type: "string" },
|
|
37
43
|
},
|
|
@@ -73,6 +79,10 @@ const TAIL_SCHEMA = {
|
|
|
73
79
|
session_id: { type: "string" },
|
|
74
80
|
run_id: { type: "string" },
|
|
75
81
|
limit: { type: "number" },
|
|
82
|
+
query: { type: "string" },
|
|
83
|
+
format: { type: "string", enum: ["json", "text"] },
|
|
84
|
+
fields: { type: "array", items: { type: "string" } },
|
|
85
|
+
template: { type: "string" },
|
|
76
86
|
backends: { type: "array", items: { type: "string" } },
|
|
77
87
|
config_path: { type: "string" },
|
|
78
88
|
},
|
|
@@ -128,7 +138,8 @@ export const startMcpServer = async (): Promise<void> => {
|
|
|
128
138
|
tools: [
|
|
129
139
|
{
|
|
130
140
|
name: "guck.search",
|
|
131
|
-
description:
|
|
141
|
+
description:
|
|
142
|
+
"Search telemetry events with filters. Supports boolean message-only query (query), JSON field projection (fields), or text formatting with template (format: text + template).",
|
|
132
143
|
inputSchema: SEARCH_SCHEMA,
|
|
133
144
|
},
|
|
134
145
|
{
|
|
@@ -143,7 +154,8 @@ export const startMcpServer = async (): Promise<void> => {
|
|
|
143
154
|
},
|
|
144
155
|
{
|
|
145
156
|
name: "guck.tail",
|
|
146
|
-
description:
|
|
157
|
+
description:
|
|
158
|
+
"Return the most recent events (non-streaming). Supports message-only boolean query (query) and output formatting (format: json/text, fields, template).",
|
|
147
159
|
inputSchema: TAIL_SCHEMA,
|
|
148
160
|
},
|
|
149
161
|
],
|
|
@@ -169,9 +181,34 @@ export const startMcpServer = async (): Promise<void> => {
|
|
|
169
181
|
...filters,
|
|
170
182
|
since: resolveSince(filters.since, config, storeDir),
|
|
171
183
|
};
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
184
|
+
try {
|
|
185
|
+
const result = await readSearch(config, rootDir, withDefaults);
|
|
186
|
+
const redacted = result.events.map((event) => redactEvent(config, event));
|
|
187
|
+
if (input.format === "text") {
|
|
188
|
+
const lines = redacted.map((event) => formatEventText(event, input.template));
|
|
189
|
+
return buildText({
|
|
190
|
+
format: "text",
|
|
191
|
+
lines,
|
|
192
|
+
truncated: result.truncated,
|
|
193
|
+
errors: result.errors,
|
|
194
|
+
});
|
|
195
|
+
}
|
|
196
|
+
if (input.fields && input.fields.length > 0) {
|
|
197
|
+
const projected = redacted.map((event) => projectEventFields(event, input.fields ?? []));
|
|
198
|
+
return buildText({
|
|
199
|
+
format: "json",
|
|
200
|
+
events: projected,
|
|
201
|
+
truncated: result.truncated,
|
|
202
|
+
errors: result.errors,
|
|
203
|
+
});
|
|
204
|
+
}
|
|
205
|
+
return buildText({ format: "json", ...result, events: redacted });
|
|
206
|
+
} catch (error) {
|
|
207
|
+
if (error instanceof Error && error.message.startsWith("Invalid query:")) {
|
|
208
|
+
return buildText({ error: error.message, query: input.query });
|
|
209
|
+
}
|
|
210
|
+
throw error;
|
|
211
|
+
}
|
|
175
212
|
}
|
|
176
213
|
|
|
177
214
|
if (request.params.name === "guck.stats") {
|
|
@@ -201,16 +238,43 @@ export const startMcpServer = async (): Promise<void> => {
|
|
|
201
238
|
const { config_path: _configPath, ...filters } = input;
|
|
202
239
|
const limit = input.limit ?? Math.min(config.mcp.max_results, 50);
|
|
203
240
|
const since = resolveSince(undefined, config, storeDir);
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
241
|
+
let result;
|
|
242
|
+
try {
|
|
243
|
+
result = await readTail(config, rootDir, {
|
|
244
|
+
service: filters.service,
|
|
245
|
+
session_id: filters.session_id,
|
|
246
|
+
run_id: filters.run_id,
|
|
247
|
+
query: filters.query,
|
|
248
|
+
limit,
|
|
249
|
+
backends: filters.backends,
|
|
250
|
+
since,
|
|
251
|
+
});
|
|
252
|
+
} catch (error) {
|
|
253
|
+
if (error instanceof Error && error.message.startsWith("Invalid query:")) {
|
|
254
|
+
return buildText({ error: error.message, query: input.query });
|
|
255
|
+
}
|
|
256
|
+
throw error;
|
|
257
|
+
}
|
|
212
258
|
const redacted = result.events.map((event) => redactEvent(config, event));
|
|
213
|
-
|
|
259
|
+
if (input.format === "text") {
|
|
260
|
+
const lines = redacted.map((event) => formatEventText(event, input.template));
|
|
261
|
+
return buildText({
|
|
262
|
+
format: "text",
|
|
263
|
+
lines,
|
|
264
|
+
truncated: result.truncated,
|
|
265
|
+
errors: result.errors,
|
|
266
|
+
});
|
|
267
|
+
}
|
|
268
|
+
if (input.fields && input.fields.length > 0) {
|
|
269
|
+
const projected = redacted.map((event) => projectEventFields(event, input.fields ?? []));
|
|
270
|
+
return buildText({
|
|
271
|
+
format: "json",
|
|
272
|
+
events: projected,
|
|
273
|
+
truncated: result.truncated,
|
|
274
|
+
errors: result.errors,
|
|
275
|
+
});
|
|
276
|
+
}
|
|
277
|
+
return buildText({ format: "json", ...result, events: redacted });
|
|
214
278
|
}
|
|
215
279
|
|
|
216
280
|
throw new Error(`Unknown tool: ${request.params.name}`);
|