jxp 4.2.0 → 5.0.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 (87) hide show
  1. package/.env.sample +16 -0
  2. package/README.md +2 -0
  3. package/dist/bin/mcp-stdio-bridge.d.ts +3 -0
  4. package/dist/bin/mcp-stdio-bridge.d.ts.map +1 -0
  5. package/dist/bin/mcp-stdio-bridge.js +87 -0
  6. package/dist/bin/mcp-stdio-bridge.js.map +1 -0
  7. package/dist/bin/server.d.ts.map +1 -1
  8. package/dist/bin/server.js +2 -1
  9. package/dist/bin/server.js.map +1 -1
  10. package/dist/libs/docs-auth.d.ts.map +1 -1
  11. package/dist/libs/docs-auth.js +4 -2
  12. package/dist/libs/docs-auth.js.map +1 -1
  13. package/dist/libs/docs.js +73 -42
  14. package/dist/libs/docs.js.map +1 -1
  15. package/dist/libs/jxp.d.ts.map +1 -1
  16. package/dist/libs/jxp.js +16 -319
  17. package/dist/libs/jxp.js.map +1 -1
  18. package/dist/libs/mcp/auth.d.ts +4 -0
  19. package/dist/libs/mcp/auth.d.ts.map +1 -0
  20. package/dist/libs/mcp/auth.js +49 -0
  21. package/dist/libs/mcp/auth.js.map +1 -0
  22. package/dist/libs/mcp/config.d.ts +21 -0
  23. package/dist/libs/mcp/config.d.ts.map +1 -0
  24. package/dist/libs/mcp/config.js +66 -0
  25. package/dist/libs/mcp/config.js.map +1 -0
  26. package/dist/libs/mcp/context.d.ts +5 -0
  27. package/dist/libs/mcp/context.d.ts.map +1 -0
  28. package/dist/libs/mcp/context.js +14 -0
  29. package/dist/libs/mcp/context.js.map +1 -0
  30. package/dist/libs/mcp/describe.d.ts +13 -0
  31. package/dist/libs/mcp/describe.d.ts.map +1 -0
  32. package/dist/libs/mcp/describe.js +36 -0
  33. package/dist/libs/mcp/describe.js.map +1 -0
  34. package/dist/libs/mcp/docs_auth.d.ts +5 -0
  35. package/dist/libs/mcp/docs_auth.d.ts.map +1 -0
  36. package/dist/libs/mcp/docs_auth.js +36 -0
  37. package/dist/libs/mcp/docs_auth.js.map +1 -0
  38. package/dist/libs/mcp/dynamic_import.d.ts +6 -0
  39. package/dist/libs/mcp/dynamic_import.d.ts.map +1 -0
  40. package/dist/libs/mcp/dynamic_import.js +12 -0
  41. package/dist/libs/mcp/dynamic_import.js.map +1 -0
  42. package/dist/libs/mcp/execute_tool.d.ts +10 -0
  43. package/dist/libs/mcp/execute_tool.d.ts.map +1 -0
  44. package/dist/libs/mcp/execute_tool.js +65 -0
  45. package/dist/libs/mcp/execute_tool.js.map +1 -0
  46. package/dist/libs/mcp/guides/default.md +67 -0
  47. package/dist/libs/mcp/guides.d.ts +14 -0
  48. package/dist/libs/mcp/guides.d.ts.map +1 -0
  49. package/dist/libs/mcp/guides.js +127 -0
  50. package/dist/libs/mcp/guides.js.map +1 -0
  51. package/dist/libs/mcp/model_visibility.d.ts +31 -0
  52. package/dist/libs/mcp/model_visibility.d.ts.map +1 -0
  53. package/dist/libs/mcp/model_visibility.js +73 -0
  54. package/dist/libs/mcp/model_visibility.js.map +1 -0
  55. package/dist/libs/mcp/mount.d.ts +10 -0
  56. package/dist/libs/mcp/mount.d.ts.map +1 -0
  57. package/dist/libs/mcp/mount.js +68 -0
  58. package/dist/libs/mcp/mount.js.map +1 -0
  59. package/dist/libs/mcp/read_service.d.ts +23 -0
  60. package/dist/libs/mcp/read_service.d.ts.map +1 -0
  61. package/dist/libs/mcp/read_service.js +141 -0
  62. package/dist/libs/mcp/read_service.js.map +1 -0
  63. package/dist/libs/mcp/server.d.ts +23 -0
  64. package/dist/libs/mcp/server.d.ts.map +1 -0
  65. package/dist/libs/mcp/server.js +111 -0
  66. package/dist/libs/mcp/server.js.map +1 -0
  67. package/dist/libs/read_handlers.d.ts +13 -0
  68. package/dist/libs/read_handlers.d.ts.map +1 -0
  69. package/dist/libs/read_handlers.js +381 -0
  70. package/dist/libs/read_handlers.js.map +1 -0
  71. package/dist/libs/schema_serialize.d.ts +3 -0
  72. package/dist/libs/schema_serialize.d.ts.map +1 -0
  73. package/dist/libs/schema_serialize.js +45 -0
  74. package/dist/libs/schema_serialize.js.map +1 -0
  75. package/dist/types/jxp-config.d.ts +7 -0
  76. package/dist/types/jxp-config.d.ts.map +1 -1
  77. package/docs/changelog.md +35 -0
  78. package/docs/index.md +1 -0
  79. package/docs/mcp.md +134 -0
  80. package/mkdocs.yml +1 -0
  81. package/package.json +11 -5
  82. package/templates/assets/docs.css +107 -0
  83. package/templates/assets/mcp-console.js +343 -0
  84. package/templates/index.pug +37 -0
  85. package/templates/mcp.pug +112 -0
  86. package/templates/navbar.pug +2 -0
  87. package/templates/sidebar.pug +4 -0
@@ -0,0 +1,381 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.parseFilter = parseFilter;
7
+ exports.getOneDocument = getOneDocument;
8
+ exports.executeList = executeList;
9
+ exports.executeGetOne = executeGetOne;
10
+ exports.executeCount = executeCount;
11
+ exports.resultToCsv = resultToCsv;
12
+ exports.buildSyntheticRequest = buildSyntheticRequest;
13
+ exports.buildSyntheticResponse = buildSyntheticResponse;
14
+ const node_querystring_1 = __importDefault(require("node:querystring"));
15
+ const errors = require("restify-errors");
16
+ const query_sanitize = require("./query_sanitize");
17
+ const query_limits = require("./query_limits");
18
+ const response_sanitize = require("./response_sanitize");
19
+ const { safeErrorMessage } = require("./safe_error");
20
+ const { logRequestError } = require("./request_log");
21
+ const { Parser: CsvParser } = require("@json2csv/plainjs");
22
+ function getStripFields(req) {
23
+ return req.config?.security?.strip_fields || ["password"];
24
+ }
25
+ function changeUrlParams(req, key, val) {
26
+ const q = { ...req.query };
27
+ q[key] = val;
28
+ const base = req.config?.server || req.config?.url || "";
29
+ const pathStr = req.path();
30
+ return base + pathStr + "?" + node_querystring_1.default.stringify(q);
31
+ }
32
+ function isISODateString(str) {
33
+ if (typeof str !== "string")
34
+ return false;
35
+ const isoDateRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?Z$/;
36
+ if (!isoDateRegex.test(str))
37
+ return false;
38
+ const date = new Date(str);
39
+ if (isNaN(date.getTime())) {
40
+ throw new errors.BadRequestError("Invalid date format");
41
+ }
42
+ return true;
43
+ }
44
+ function parseFilter(filter, depth = 0) {
45
+ const MAX_DEPTH = 10;
46
+ if (!filter)
47
+ return {};
48
+ if (depth > MAX_DEPTH) {
49
+ throw new errors.BadRequestError("Maximum filter depth exceeded");
50
+ }
51
+ if (typeof filter !== "object" || filter === null)
52
+ return filter;
53
+ if (Array.isArray(filter)) {
54
+ const result = {};
55
+ filter.forEach((item) => {
56
+ if (typeof item === "string" && item.includes(":")) {
57
+ const parts = item.split(":");
58
+ const key = parts[0];
59
+ const value = parts.slice(1).join(":");
60
+ if (key.startsWith("$")) {
61
+ try {
62
+ if (isISODateString(value)) {
63
+ result[key] = new Date(value);
64
+ }
65
+ else {
66
+ result[key] = value;
67
+ }
68
+ }
69
+ catch (err) {
70
+ if (err instanceof errors.BadRequestError)
71
+ throw err;
72
+ throw new errors.BadRequestError("Invalid date format");
73
+ }
74
+ }
75
+ }
76
+ });
77
+ return result;
78
+ }
79
+ const parsedFilter = {};
80
+ const filterObj = filter;
81
+ for (const i in filterObj) {
82
+ if (filterObj[i] === "false") {
83
+ parsedFilter[i] = false;
84
+ continue;
85
+ }
86
+ if (filterObj[i] === "true") {
87
+ parsedFilter[i] = true;
88
+ continue;
89
+ }
90
+ if (typeof filterObj[i] === "string") {
91
+ try {
92
+ if (isISODateString(filterObj[i])) {
93
+ parsedFilter[i] = new Date(filterObj[i]);
94
+ continue;
95
+ }
96
+ }
97
+ catch (err) {
98
+ if (err instanceof errors.BadRequestError)
99
+ throw err;
100
+ throw new errors.BadRequestError("Invalid date format");
101
+ }
102
+ const strVal = filterObj[i];
103
+ if (strVal.includes(":")) {
104
+ const parts = strVal.split(":");
105
+ const key = parts[0];
106
+ const value = parts.slice(1).join(":");
107
+ if (key.startsWith("$")) {
108
+ try {
109
+ if (isISODateString(value)) {
110
+ if (!parsedFilter[i])
111
+ parsedFilter[i] = {};
112
+ parsedFilter[i][key] = new Date(value);
113
+ }
114
+ else if (value.startsWith("[") && value.endsWith("]")) {
115
+ if (!parsedFilter[i])
116
+ parsedFilter[i] = {};
117
+ parsedFilter[i][key] = value.slice(1, -1).split(",");
118
+ }
119
+ else if (key === "$regex" && value.startsWith("/")) {
120
+ if (!parsedFilter[i])
121
+ parsedFilter[i] = {};
122
+ const match = value.match(/^\/(.+?)\/([gimy]*)$/);
123
+ if (match) {
124
+ parsedFilter[i][key] = new RegExp(match[1], match[2]);
125
+ }
126
+ }
127
+ else {
128
+ if (!parsedFilter[i])
129
+ parsedFilter[i] = {};
130
+ parsedFilter[i][key] = value;
131
+ }
132
+ }
133
+ catch (err) {
134
+ if (err instanceof errors.BadRequestError)
135
+ throw err;
136
+ throw new errors.BadRequestError("Invalid date format");
137
+ }
138
+ }
139
+ else {
140
+ parsedFilter[i] = filterObj[i];
141
+ }
142
+ }
143
+ else {
144
+ parsedFilter[i] = filterObj[i];
145
+ }
146
+ }
147
+ else if (Array.isArray(filterObj[i])) {
148
+ parsedFilter[i] = parseFilter(filterObj[i], depth + 1);
149
+ }
150
+ else if (typeof filterObj[i] === "object") {
151
+ parsedFilter[i] = parseFilter(filterObj[i], depth + 1);
152
+ }
153
+ else {
154
+ parsedFilter[i] = filterObj[i];
155
+ }
156
+ }
157
+ return parsedFilter;
158
+ }
159
+ async function getOneDocument(Model, item_id, params, options) {
160
+ const query = Model.findById(item_id, {}, options);
161
+ if (params.populate) {
162
+ if (typeof params.populate === "object" && !Array.isArray(params.populate)) {
163
+ for (const i in params.populate) {
164
+ query.populate(i, params.populate[i].replace(/,/g, " "));
165
+ }
166
+ }
167
+ else {
168
+ query.populate(params.populate);
169
+ }
170
+ }
171
+ if (params.autopopulate) {
172
+ for (const key in Model.schema.paths) {
173
+ const dirpath = Model.schema.paths[key];
174
+ if (dirpath.instance == "ObjectID" && dirpath.options.link) {
175
+ query.populate(String(dirpath.options.map_to || dirpath.options.virtual || dirpath.options.link.toLowerCase()));
176
+ }
177
+ }
178
+ }
179
+ try {
180
+ const item = await query.exec();
181
+ if (!item) {
182
+ throw new errors.NotFoundError(`Could not find document ${item_id} on ${Model.modelName}`);
183
+ }
184
+ if (item._deleted && !params.showDeleted) {
185
+ throw new errors.NotFoundError(`Document ${item_id} is deleted on ${Model.modelName}`);
186
+ }
187
+ return response_sanitize.sanitizeDocument(item);
188
+ }
189
+ catch (err) {
190
+ if (err.code)
191
+ throw err;
192
+ throw new errors.InternalServerError(safeErrorMessage(err));
193
+ }
194
+ }
195
+ async function executeList(req, res) {
196
+ let filters = {};
197
+ try {
198
+ filters = parseFilter(req.query.filter);
199
+ filters = query_sanitize.sanitizeFilter(filters, req.config?.security || {});
200
+ }
201
+ catch (err) {
202
+ logRequestError(req, res, err, "filter");
203
+ if (err instanceof errors.BadRequestError || err instanceof errors.ForbiddenError)
204
+ throw err;
205
+ throw new errors.InternalServerError(safeErrorMessage(err));
206
+ }
207
+ const search = query_sanitize.parseSearchObject(req.query.search);
208
+ for (const i in search) {
209
+ filters[i] = search[i];
210
+ }
211
+ let countquery = filters;
212
+ let qcount = req.Model.find(filters);
213
+ let q = req.Model.find(filters);
214
+ const checkDeleted = [{ _deleted: false }, { _deleted: null }];
215
+ if (!req.query.showDeleted) {
216
+ countquery = Object.assign({ $or: checkDeleted }, countquery);
217
+ qcount.or(checkDeleted);
218
+ q.or(checkDeleted);
219
+ }
220
+ if (req.query.search && typeof req.query.search === "string") {
221
+ q = req.Model.find({ $text: { $search: req.query.search } }, { score: { $meta: "textScore" } }).sort({ score: { $meta: "textScore" } });
222
+ countquery = Object.assign({ $text: { $search: req.query.search } }, countquery);
223
+ qcount = req.Model.find({ $text: { $search: req.query.search } });
224
+ }
225
+ if (res.user) {
226
+ q.options = { user: res.user };
227
+ }
228
+ try {
229
+ const estimatedCount = await req.Model.estimatedDocumentCount();
230
+ const result = {};
231
+ const { limit: effectiveLimit, limitCapped, filterExemption } = query_limits.enforceListLimit(req, estimatedCount, res, { result, bodyQuery: filters });
232
+ let count = -1;
233
+ if (query_limits.shouldRunCount(req, { filterExemption, limitCapped })) {
234
+ if (estimatedCount < 100000 && Object.keys(countquery).length !== 0) {
235
+ count = await qcount.countDocuments();
236
+ }
237
+ else {
238
+ count = estimatedCount;
239
+ }
240
+ }
241
+ if (count >= 0) {
242
+ result.count = count;
243
+ }
244
+ query_limits.applyListPagination(q, result, req, effectiveLimit, count >= 0 ? count : 0, changeUrlParams);
245
+ if (req.query.sort) {
246
+ q.sort(req.query.sort);
247
+ result.sort = req.query.sort;
248
+ }
249
+ if (req.query.populate) {
250
+ if (typeof req.query.populate === "object" && !Array.isArray(req.query.populate)) {
251
+ for (const i in req.query.populate) {
252
+ q.populate(i, req.query.populate[i].replace(/,/g, " "));
253
+ }
254
+ }
255
+ else {
256
+ q.populate(req.query.populate);
257
+ }
258
+ result.populate = req.query.populate;
259
+ }
260
+ if (req.query.autopopulate) {
261
+ for (const key in req.Model.schema.paths) {
262
+ const dirpath = req.Model.schema.paths[key];
263
+ if (dirpath.instance == "ObjectID" && dirpath.options.link) {
264
+ q.populate(String(dirpath.options.map_to || dirpath.options.virtual || dirpath.options.link.toLowerCase()));
265
+ }
266
+ }
267
+ result.autopopulate = true;
268
+ }
269
+ if (req.query.fields && typeof req.query.fields === "string") {
270
+ const fields = req.query.fields.split(",");
271
+ const select = {};
272
+ fields.forEach((field) => {
273
+ select[field] = 1;
274
+ });
275
+ q.select(select);
276
+ }
277
+ if (req.query.search) {
278
+ result.search = req.query.search;
279
+ }
280
+ result.data = await q.exec();
281
+ response_sanitize.sanitizeListResult(result, getStripFields(req));
282
+ query_limits.finalizeListPagination(result, req, Array.isArray(result.data) ? result.data.length : 0, effectiveLimit, count, changeUrlParams);
283
+ query_limits.enforceResponseSize(result, req, res);
284
+ res.result = result;
285
+ }
286
+ catch (err) {
287
+ if (!(err instanceof errors.BadRequestError) &&
288
+ !(err instanceof errors.ForbiddenError) &&
289
+ !(err instanceof errors.PayloadTooLargeError)) {
290
+ logRequestError(req, res, err, "get");
291
+ }
292
+ if (err instanceof errors.BadRequestError)
293
+ throw err;
294
+ if (err instanceof errors.ForbiddenError)
295
+ throw err;
296
+ if (err instanceof errors.PayloadTooLargeError)
297
+ throw err;
298
+ if (err.code)
299
+ throw err;
300
+ throw new errors.InternalServerError(safeErrorMessage(err));
301
+ }
302
+ }
303
+ async function executeGetOne(req, res) {
304
+ try {
305
+ const data = await getOneDocument(req.Model, req.params.item_id, req.query, { user: res.user });
306
+ res.result = { data };
307
+ }
308
+ catch (err) {
309
+ logRequestError(req, res, err, "getOne");
310
+ if (err.code)
311
+ throw err;
312
+ throw new errors.InternalServerError(safeErrorMessage(err));
313
+ }
314
+ }
315
+ async function executeCount(req, res) {
316
+ let filters = {};
317
+ try {
318
+ filters = parseFilter(req.query.filter);
319
+ filters = query_sanitize.sanitizeFilter(filters, req.config?.security || {});
320
+ }
321
+ catch (err) {
322
+ logRequestError(req, res, err, "filter");
323
+ if (err instanceof errors.BadRequestError || err instanceof errors.ForbiddenError)
324
+ throw err;
325
+ throw new errors.InternalServerError(safeErrorMessage(err));
326
+ }
327
+ const search = query_sanitize.parseSearchObject(req.query.search);
328
+ for (const i in search) {
329
+ filters[i] = search[i];
330
+ }
331
+ if (!req.query.showDeleted) {
332
+ filters = Object.assign({ $or: [{ _deleted: false }, { _deleted: null }] }, filters);
333
+ }
334
+ try {
335
+ const count = await req.Model.countDocuments(filters).exec();
336
+ res.result = { count };
337
+ }
338
+ catch (err) {
339
+ logRequestError(req, res, err, "count");
340
+ if (err.code)
341
+ throw err;
342
+ throw new errors.InternalServerError(safeErrorMessage(err));
343
+ }
344
+ }
345
+ function resultToCsv(result) {
346
+ if (!result.data || !Array.isArray(result.data) || !result.data.length) {
347
+ throw new errors.BadRequestError("No data to export");
348
+ }
349
+ const opts = { flatten: true };
350
+ const data = result.data.map((row) => row._doc || row);
351
+ return new CsvParser(opts).parse(data);
352
+ }
353
+ function buildSyntheticRequest(config, modelname, Model, query, params = {}) {
354
+ return {
355
+ params,
356
+ query,
357
+ headers: {},
358
+ method: "GET",
359
+ modelname,
360
+ Model,
361
+ config,
362
+ path: () => `/api/${modelname}`,
363
+ };
364
+ }
365
+ function buildSyntheticResponse(user, groups) {
366
+ return {
367
+ user,
368
+ groups,
369
+ header: () => undefined,
370
+ status: function () {
371
+ return this;
372
+ },
373
+ send: () => undefined,
374
+ json: () => undefined,
375
+ redirect: () => undefined,
376
+ writeHead: () => undefined,
377
+ write: () => undefined,
378
+ end: () => undefined,
379
+ };
380
+ }
381
+ //# sourceMappingURL=read_handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read_handlers.js","sourceRoot":"","sources":["../../src/libs/read_handlers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ /** Safely serialize a Mongoose schema path for API/MCP describe output. */
2
+ export declare function serializeField(field: any): Record<string, unknown>;
3
+ //# sourceMappingURL=schema_serialize.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema_serialize.d.ts","sourceRoot":"","sources":["../../src/libs/schema_serialize.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsClE"}
@@ -0,0 +1,45 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.serializeField = serializeField;
4
+ /** Safely serialize a Mongoose schema path for API/MCP describe output. */
5
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
6
+ function serializeField(field) {
7
+ const safeField = {
8
+ path: field.path,
9
+ instance: field.instance,
10
+ options: { ...field.options },
11
+ validators: field.validators?.map((v) => ({
12
+ type: v.type?.name,
13
+ message: v.message,
14
+ })),
15
+ isRequired: field.isRequired,
16
+ };
17
+ if (typeof field.defaultValue === "function") {
18
+ safeField.defaultValue = "[Function]";
19
+ }
20
+ else if (field.defaultValue === undefined && field.options.default !== undefined) {
21
+ if (typeof field.options.default === "function") {
22
+ safeField.defaultValue = "[Function]";
23
+ }
24
+ else {
25
+ safeField.defaultValue = field.options.default;
26
+ }
27
+ }
28
+ else {
29
+ safeField.defaultValue = field.defaultValue;
30
+ }
31
+ if (field.instance === "Array" && field.caster) {
32
+ safeField.arrayType = field.caster.instance;
33
+ if (Array.isArray(safeField.defaultValue)) {
34
+ safeField.defaultValue = JSON.stringify(safeField.defaultValue);
35
+ }
36
+ }
37
+ if (field.instance === "Embedded" || field.instance === "DocumentArray") {
38
+ safeField.schema = Object.keys(field.schema.paths).map((p) => ({
39
+ path: p,
40
+ type: field.schema.paths[p].instance,
41
+ }));
42
+ }
43
+ return safeField;
44
+ }
45
+ //# sourceMappingURL=schema_serialize.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema_serialize.js","sourceRoot":"","sources":["../../src/libs/schema_serialize.ts"],"names":[],"mappings":";;AAEA,wCAsCC;AAxCD,2EAA2E;AAC3E,8DAA8D;AAC9D,SAAgB,cAAc,CAAC,KAAU;IACxC,MAAM,SAAS,GAA4B;QAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;QAC7B,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAiD,EAAE,EAAE,CAAC,CAAC;YACzF,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;SAClB,CAAC,CAAC;QACH,UAAU,EAAE,KAAK,CAAC,UAAU;KAC5B,CAAC;IAEF,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC9C,SAAS,CAAC,YAAY,GAAG,YAAY,CAAC;IACvC,CAAC;SAAM,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACpF,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACjD,SAAS,CAAC,YAAY,GAAG,YAAY,CAAC;QACvC,CAAC;aAAM,CAAC;YACP,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAChD,CAAC;IACF,CAAC;SAAM,CAAC;QACP,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAC7C,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAChD,SAAS,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3C,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACjE,CAAC;IACF,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;QACzE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;YACtE,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ;SACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}
@@ -57,6 +57,12 @@ export interface JXPIndexDiagnosticsConfig {
57
57
  enabled?: boolean;
58
58
  query_monitor?: JXPQueryMonitorConfig;
59
59
  }
60
+ export interface JXPMcpConfig {
61
+ /** Appended after built-in MCP server instructions */
62
+ instructions?: string;
63
+ /** Markdown files merged after default.md (paths relative to cwd or absolute) */
64
+ guideFiles?: string[];
65
+ }
60
66
  export interface ResolvedIndexDiagnosticsConfig {
61
67
  enabled: boolean;
62
68
  query_monitor: Required<JXPQueryMonitorConfig>;
@@ -128,6 +134,7 @@ export interface JXPConfig {
128
134
  post_hooks?: {
129
135
  login?: (req: JXPRequest, res: JXPResponse) => void | Promise<void>;
130
136
  };
137
+ mcp?: JXPMcpConfig;
131
138
  }
132
139
  /** Restify request extended by JXP middleware. */
133
140
  export interface JXPRequest {
@@ -1 +1 @@
1
- {"version":3,"file":"jxp-config.d.ts","sourceRoot":"","sources":["../../src/types/jxp-config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"jxp-config.d.ts","sourceRoot":"","sources":["../../src/types/jxp-config.ts"],"names":[],"mappings":"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"}
package/docs/changelog.md CHANGED
@@ -2,6 +2,41 @@
2
2
 
3
3
  Notable changes to [JXP](https://github.com/WorkSpaceMan/jxp).
4
4
 
5
+ ## v5.0.0 — 2026-06-11
6
+
7
+ Read-only **MCP (Model Context Protocol)** server embedded in JXP: five fixed tools, HTTP Streamable transport, stdio bridge for Cursor/LM Studio, and LLM guidance via server instructions plus a `jxp-guide` resource.
8
+
9
+ ### MCP server
10
+
11
+ #### Added
12
+
13
+ - **HTTP MCP endpoint** — `MCP_ENABLED=true` mounts `GET`/`POST` on `MCP_PATH` (default `/mcp`) on the same port as the REST API. Stateless Streamable HTTP (per-request transport).
14
+ - **Five fixed read-only tools** — `jxp_list_models`, `jxp_describe_model`, `jxp_find`, `jxp_count`, `jxp_export_csv`. Reuses [`read_handlers`](src/libs/read_handlers.ts); same permissions as REST `GET`.
15
+ - **Model visibility** — default-hide built-in auth models and `internal: true` schemas; `MCP_MODEL_WHITELIST` / `MCP_MODEL_BLACKLIST` env overrides.
16
+ - **MCP query limits** — stricter overlay (`MCP_DEFAULT_LIMIT`, `MCP_MAX_LIMIT`, response/CSV caps, string truncation).
17
+ - **LLM guidance** — server `instructions` on `initialize`; **`jxp-guide`** resource (`jxp://guide`) with built-in markdown plus app extensions via `JXPConfig.mcp` / `MCP_GUIDE_FILES`.
18
+ - **`jxp-mcp` CLI** — stdio bridge (`dist/bin/mcp-stdio-bridge.js`) proxies tools, resources, and instructions to a remote HTTP MCP endpoint. Env: `JXP_URL`, `JXP_API_KEY`, optional `MCP_PATH`.
19
+ - **Docs** — [MCP](mcp.md), `.env.sample` entries, Cursor rule `.cursor/rules/mcp.mdc`.
20
+
21
+ #### Dependencies
22
+
23
+ - `@modelcontextprotocol/server`, `@modelcontextprotocol/node`, `@modelcontextprotocol/client` (v2 alpha)
24
+ - `zod`, `@cfworker/json-schema` (peer for MCP client)
25
+
26
+ #### Migration
27
+
28
+ | Topic | Action |
29
+ |-------|--------|
30
+ | Opt-in | MCP is **off** by default. Set `MCP_ENABLED=true` to expose `/mcp`. |
31
+ | REST API | Unchanged when MCP is disabled. |
32
+ | New deps | `npm install` pulls MCP packages; Node **22+** (unchanged). |
33
+ | Cursor (HTTP) | `"url": "https://api.example.com/mcp"`, header `X-API-Key`. |
34
+ | Cursor (stdio) | `"command": "npx", "args": ["-y", "jxp-mcp"]`, env `JXP_URL` + `JXP_API_KEY`. |
35
+
36
+ `jxp-mcp` is **not** a separate npm package — it ships as a **bin entry on the `jxp` package** (`npx jxp-mcp` after `npm install jxp@5`). The bridge talks to a running JXP HTTP server; it does not embed the API.
37
+
38
+ ---
39
+
5
40
  ## v4.2.0 — 2026-05-26
6
41
 
7
42
  Query limit improvements, index diagnostics (audit CLI, admin API, docs UI, query monitor), built-in framework models, and MongoDB version in the startup banner.
package/docs/index.md CHANGED
@@ -18,6 +18,7 @@ JXP 4 requires **Node.js 22+**, ships as compiled TypeScript, and uses environme
18
18
  * Stateless and easy to deploy
19
19
  * WebSocket change subscriptions
20
20
  * [Index diagnostics](index_diagnostics.md) — schema vs DB indexes and optional query monitoring
21
+ * [MCP](mcp.md) — read-only Model Context Protocol for AI clients (Cursor, LM Studio); optional `jxp-mcp` stdio bridge
21
22
 
22
23
  ## Links
23
24