@usex/mikrotik-mcp 3.29.0 → 3.30.0

package/dist/cli.js

@@ -23,7 +23,8 @@ var McpServerSettingsSchema = z.object({
   allowedHosts: z.string().default(""),
   allowedOrigins: z.string().default(""),
   corsOrigins: z.string().default(""),
-  toolPageSize: z.coerce.number().int().min(0).default(0)
+  toolPageSize: z.coerce.number().int().min(0).default(0),
+  appViews: z.boolean().default(true)
 });
 var DeviceConfigSchema = z.object({
   host: z.string().default("127.0.0.1"),
@@ -121,7 +122,8 @@ function parseDevicesSource(raw, fromFile) {
   const s3 = structured && obj.s3 && typeof obj.s3 === "object" ? obj.s3 : undefined;
   const dashboard = structured && obj.dashboard && typeof obj.dashboard === "object" ? obj.dashboard : undefined;
   const tools = structured && obj.tools && typeof obj.tools === "object" ? obj.tools : undefined;
-  return { devices, defaultDevice, s3, dashboard, tools };
+  const mcp = structured && obj.mcp && typeof obj.mcp === "object" ? obj.mcp : undefined;
+  return { devices, defaultDevice, s3, dashboard, tools, mcp };
 }
 var configSource = { path: DEFAULT_CONFIG_FILE, fromFile: false };
 function getConfigSource() {
@@ -157,6 +159,7 @@ function loadConfig(argv = process.argv.slice(2)) {
   let fileS3 = {};
   let fileDashboard = {};
   let fileTools;
+  let fileMcp;
   if (configFile || devicesInline) {
     const src = configFile ? parseDevicesSource(configFile, true) : parseDevicesSource(devicesInline, false);
     for (const [name, dc] of Object.entries(src.devices))
@@ -168,6 +171,7 @@ function loadConfig(argv = process.argv.slice(2)) {
     fileS3 = src.s3;
     fileDashboard = src.dashboard;
     fileTools = src.tools;
+    fileMcp = src.mcp;
   }
   const s3 = {
     accessKeyId: pick("s3-access-key-id", "S3_ACCESS_KEY_ID", "AWS_ACCESS_KEY_ID"),
@@ -180,6 +184,8 @@ function loadConfig(argv = process.argv.slice(2)) {
     presignExpiresIn: pick("s3-presign-expires-in", "MIKROTIK_S3_PRESIGN_EXPIRES_IN"),
     ...fileS3
   };
+  const appViewsRaw = pick("app-views", "MIKROTIK_MCP__APP_VIEWS");
+  const appViewsEnv = appViewsRaw === undefined ? undefined : !/^(0|false|no|off)$/i.test(appViewsRaw);
   const mcp = {
     transport: pick("transport", "MIKROTIK_MCP__TRANSPORT", "MCP_TRANSPORT"),
     host: pick("mcp-host", "MIKROTIK_MCP__HOST"),
@@ -187,7 +193,9 @@ function loadConfig(argv = process.argv.slice(2)) {
     allowedHosts: pick("mcp-allowed-hosts", "MIKROTIK_MCP__ALLOWED_HOSTS"),
     allowedOrigins: pick("mcp-allowed-origins", "MIKROTIK_MCP__ALLOWED_ORIGINS"),
     corsOrigins: pick("mcp-cors-origins", "MIKROTIK_MCP__CORS_ORIGINS"),
-    toolPageSize: pick("tool-page-size", "MIKROTIK_MCP__TOOL_PAGE_SIZE")
+    toolPageSize: pick("tool-page-size", "MIKROTIK_MCP__TOOL_PAGE_SIZE"),
+    appViews: appViewsEnv,
+    ...fileMcp
   };
   const isTruthy = (v) => /^(1|true|yes|on)$/i.test(v ?? "");
   const readOnly = isTruthy(pick("read-only", "MIKROTIK_READ_ONLY"));
@@ -1794,9 +1802,9 @@ function defineTool(def) {
     inputSchema: def.inputSchema,
     ui: def.ui,
     register(server, opts = {}) {
-      const { sendLog, deviceNames, deviceAliases, deviceDirectory: deviceDirectory2 } = opts;
+      const { sendLog, deviceNames, deviceAliases, deviceDirectory: deviceDirectory2, appViews } = opts;
       const multiDevice = !!deviceNames && deviceNames.length > 1;
-      const { ui, auto } = effectiveUi(def);
+      const { ui, auto } = appViews === false ? { ui: undefined, auto: false } : effectiveUi(def);
       const selectorNames = multiDevice && deviceNames ? [...new Set([...deviceNames, ...deviceAliases ?? []])] : [];
       const inputSchema = multiDevice ? {
         ...def.inputSchema,
@@ -27067,7 +27075,7 @@ function registerPrompts(server) {
 // package.json
 var package_default = {
   name: "@usex/mikrotik-mcp",
-  version: "3.29.0",
+  version: "3.30.0",
   description: "MCP server for MikroTik RouterOS \u2014 660+ tools over SSH for firewall, NAT, routing, DHCP, DNS, WireGuard, wireless, QoS and more.",
   keywords: [
     "ai",
@@ -27273,6 +27281,7 @@ function createServer(opts = {}) {
     deviceNames: names,
     deviceAliases: deviceLabels(),
     deviceDirectory: deviceDirectory(),
+    appViews: getConfig().mcp.appViews,
     readOnly
   });
   const promptCount = registerPrompts(server);

package/dist/index.d.ts

@@ -94,6 +94,14 @@ interface RegisterOptions {
 	*/
 	deviceDirectory?: DeviceDirectoryEntry[];
 	/**
+	* Emit MCP App view metadata (`_meta.ui`) on tools. Default true. Set false for
+	* hosts whose tool discovery hides/deprioritises tools that carry App/
+	* `openai/outputTemplate` metadata — without it, every `list_*`/`get_*` read
+	* tool gains the auto-records view and some clients then surface only the
+	* (metadata-free) write tools. Disabling makes reads plain, surfacing tools.
+	*/
+	appViews?: boolean;
+	/**
 	* Read-only mode: register only tools annotated `readOnlyHint`. Used to
 	* withhold every write/destructive tool from a publicly-exposed surface (e.g.
 	* a ChatGPT Apps connector) until authentication is in place.

package/dist/index.js

@@ -19,7 +19,8 @@ var McpServerSettingsSchema = z.object({
   allowedHosts: z.string().default(""),
   allowedOrigins: z.string().default(""),
   corsOrigins: z.string().default(""),
-  toolPageSize: z.coerce.number().int().min(0).default(0)
+  toolPageSize: z.coerce.number().int().min(0).default(0),
+  appViews: z.boolean().default(true)
 });
 var DeviceConfigSchema = z.object({
   host: z.string().default("127.0.0.1"),
@@ -117,7 +118,8 @@ function parseDevicesSource(raw, fromFile) {
   const s3 = structured && obj.s3 && typeof obj.s3 === "object" ? obj.s3 : undefined;
   const dashboard = structured && obj.dashboard && typeof obj.dashboard === "object" ? obj.dashboard : undefined;
   const tools = structured && obj.tools && typeof obj.tools === "object" ? obj.tools : undefined;
-  return { devices, defaultDevice, s3, dashboard, tools };
+  const mcp = structured && obj.mcp && typeof obj.mcp === "object" ? obj.mcp : undefined;
+  return { devices, defaultDevice, s3, dashboard, tools, mcp };
 }
 var configSource = { path: DEFAULT_CONFIG_FILE, fromFile: false };
 function loadConfig(argv = process.argv.slice(2)) {
@@ -150,6 +152,7 @@ function loadConfig(argv = process.argv.slice(2)) {
   let fileS3 = {};
   let fileDashboard = {};
   let fileTools;
+  let fileMcp;
   if (configFile || devicesInline) {
     const src = configFile ? parseDevicesSource(configFile, true) : parseDevicesSource(devicesInline, false);
     for (const [name, dc] of Object.entries(src.devices))
@@ -161,6 +164,7 @@ function loadConfig(argv = process.argv.slice(2)) {
     fileS3 = src.s3;
     fileDashboard = src.dashboard;
     fileTools = src.tools;
+    fileMcp = src.mcp;
   }
   const s3 = {
     accessKeyId: pick("s3-access-key-id", "S3_ACCESS_KEY_ID", "AWS_ACCESS_KEY_ID"),
@@ -173,6 +177,8 @@ function loadConfig(argv = process.argv.slice(2)) {
     presignExpiresIn: pick("s3-presign-expires-in", "MIKROTIK_S3_PRESIGN_EXPIRES_IN"),
     ...fileS3
   };
+  const appViewsRaw = pick("app-views", "MIKROTIK_MCP__APP_VIEWS");
+  const appViewsEnv = appViewsRaw === undefined ? undefined : !/^(0|false|no|off)$/i.test(appViewsRaw);
   const mcp = {
     transport: pick("transport", "MIKROTIK_MCP__TRANSPORT", "MCP_TRANSPORT"),
     host: pick("mcp-host", "MIKROTIK_MCP__HOST"),
@@ -180,7 +186,9 @@ function loadConfig(argv = process.argv.slice(2)) {
     allowedHosts: pick("mcp-allowed-hosts", "MIKROTIK_MCP__ALLOWED_HOSTS"),
     allowedOrigins: pick("mcp-allowed-origins", "MIKROTIK_MCP__ALLOWED_ORIGINS"),
     corsOrigins: pick("mcp-cors-origins", "MIKROTIK_MCP__CORS_ORIGINS"),
-    toolPageSize: pick("tool-page-size", "MIKROTIK_MCP__TOOL_PAGE_SIZE")
+    toolPageSize: pick("tool-page-size", "MIKROTIK_MCP__TOOL_PAGE_SIZE"),
+    appViews: appViewsEnv,
+    ...fileMcp
   };
   const isTruthy = (v) => /^(1|true|yes|on)$/i.test(v ?? "");
   const readOnly = isTruthy(pick("read-only", "MIKROTIK_READ_ONLY"));
@@ -1700,9 +1708,9 @@ function defineTool(def) {
     inputSchema: def.inputSchema,
     ui: def.ui,
     register(server, opts = {}) {
-      const { sendLog, deviceNames, deviceAliases, deviceDirectory: deviceDirectory2 } = opts;
+      const { sendLog, deviceNames, deviceAliases, deviceDirectory: deviceDirectory2, appViews } = opts;
       const multiDevice = !!deviceNames && deviceNames.length > 1;
-      const { ui, auto } = effectiveUi(def);
+      const { ui, auto } = appViews === false ? { ui: undefined, auto: false } : effectiveUi(def);
       const selectorNames = multiDevice && deviceNames ? [...new Set([...deviceNames, ...deviceAliases ?? []])] : [];
       const inputSchema = multiDevice ? {
         ...def.inputSchema,
@@ -25045,7 +25053,7 @@ function selectToolModules(filter = {}, catalog = moduleCatalog) {
 // package.json
 var package_default = {
   name: "@usex/mikrotik-mcp",
-  version: "3.29.0",
+  version: "3.30.0",
   description: "MCP server for MikroTik RouterOS \u2014 660+ tools over SSH for firewall, NAT, routing, DHCP, DNS, WireGuard, wireless, QoS and more.",
   keywords: [
     "ai",
@@ -25251,6 +25259,7 @@ function createServer(opts = {}) {
     deviceNames: names,
     deviceAliases: deviceLabels(),
     deviceDirectory: deviceDirectory(),
+    appViews: getConfig().mcp.appViews,
     readOnly
   });
   const promptCount = registerPrompts(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usex/mikrotik-mcp",
-  "version": "3.29.0",
+  "version": "3.30.0",
   "description": "MCP server for MikroTik RouterOS — 660+ tools over SSH for firewall, NAT, routing, DHCP, DNS, WireGuard, wireless, QoS and more.",
   "keywords": [
     "ai",

package/schemas/config.schema.json

@@ -87,7 +87,8 @@
         "allowedHosts": "",
         "allowedOrigins": "",
         "corsOrigins": "",
-        "toolPageSize": 0
+        "toolPageSize": 0,
+        "appViews": true
       },
       "type": "object",
       "properties": {
@@ -123,6 +124,10 @@
           "type": "integer",
           "minimum": 0,
           "maximum": 9007199254740991
+        },
+        "appViews": {
+          "default": true,
+          "type": "boolean"
         }
       },
       "required": [
@@ -132,7 +137,8 @@
         "allowedHosts",
         "allowedOrigins",
         "corsOrigins",
-        "toolPageSize"
+        "toolPageSize",
+        "appViews"
       ],
       "additionalProperties": false
     },

package/schemas/tool-catalog.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.28.0",
+  "version": "3.29.0",
   "generated": "by scripts/gen-schemas.ts — do not edit by hand",
   "toolCount": 758,
   "tools": [