@usex/mikrotik-mcp 4.0.0 → 4.2.0

package/README.md

@@ -113,7 +113,7 @@ precedence over a password. Full configuration reference:
 ### From source
 
 ```bash
-git clone https://github.com/ali-master/mikrotik-mcp && cd mikrotik-mcp
+git clone https://github.com/mikrotik-mcp/mikrotik-mcp && cd mikrotik-mcp
 bun install
 bun run start            # serve from source
 bun run build            # bundle to dist/

package/dist/cli.js

@@ -106,7 +106,7 @@ import {
   updateAaaEntity,
   updateSummaryLine,
   writeBackup
-} from "./shared/cli-athwegwy.js";
+} from "./shared/cli-365rqpy1.js";
 
 // src/cli.ts
 import { existsSync as existsSync2 } from "fs";
@@ -2723,11 +2723,31 @@ accepts an optional "device" argument to choose which router it runs on; omit it
 to use the default. Use list_mikrotik_devices to see them. For cross-device work
 (e.g. a tunnel between two routers) configure each side by passing the matching
 "device", then verify reachability with ping/traceroute from each end.`;
+var MEMORY_INSTRUCTIONS = `
+
+Persistent memory \u2014 you have a knowledge graph that survives across sessions
+(entities, observations, relations in a local SQLite database). USE IT on every
+task so context is never lost between conversations:
+  1. AT THE START of a task, recall what you already know before touching the
+     device: call \`memory_search_nodes\` for the device/subject at hand (or
+     \`memory_read_graph\` for the whole picture on a fresh device). Apply what you
+     find \u2014 do not re-discover facts you already recorded.
+  2. WHILE WORKING, when you learn a durable fact about the network, a device, a
+     user, or a config pattern (RouterOS version, port layout, VLAN scheme, WAN
+     uplink, owner, recurring fix), record it: \`memory_create_entities\` for new
+     subjects, \`memory_add_observations\` for facts about existing ones, and
+     \`memory_create_relations\` to link them (e.g. router --provides_dhcp_for-->
+     subnet). Every device you touch is auto-added as an entity, so attach
+     observations to it by name.
+  3. Prefer specific, reusable facts over transient state. Skip one-off command
+     output; record what will still be true next session.`;
 function createServer(opts = {}) {
   process.title = `Mikrotik MCP Server v${VERSION}`;
   const { names, default: defaultDevice } = listDevices();
   const readOnly = getConfig().readOnly;
   let instructions = names.length > 1 ? INSTRUCTIONS + MULTI_DEVICE_INSTRUCTIONS.replace("{{names}}", names.join(", ")).replace("{{default}}", defaultDevice) : INSTRUCTIONS;
+  if (getConfig().memory.enabled)
+    instructions += MEMORY_INSTRUCTIONS;
   if (!getConfig().disableUpdateCheck) {
     const cached = loadFileCacheSync();
     if (cached) {

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   selectToolModules,
   setConfig,
   updateSummaryLine
-} from "./shared/library-f5kwsqv2.js";
+} from "./shared/library-ndn9hj45.js";
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
@@ -201,11 +201,31 @@ accepts an optional "device" argument to choose which router it runs on; omit it
 to use the default. Use list_mikrotik_devices to see them. For cross-device work
 (e.g. a tunnel between two routers) configure each side by passing the matching
 "device", then verify reachability with ping/traceroute from each end.`;
+var MEMORY_INSTRUCTIONS = `
+
+Persistent memory \u2014 you have a knowledge graph that survives across sessions
+(entities, observations, relations in a local SQLite database). USE IT on every
+task so context is never lost between conversations:
+  1. AT THE START of a task, recall what you already know before touching the
+     device: call \`memory_search_nodes\` for the device/subject at hand (or
+     \`memory_read_graph\` for the whole picture on a fresh device). Apply what you
+     find \u2014 do not re-discover facts you already recorded.
+  2. WHILE WORKING, when you learn a durable fact about the network, a device, a
+     user, or a config pattern (RouterOS version, port layout, VLAN scheme, WAN
+     uplink, owner, recurring fix), record it: \`memory_create_entities\` for new
+     subjects, \`memory_add_observations\` for facts about existing ones, and
+     \`memory_create_relations\` to link them (e.g. router --provides_dhcp_for-->
+     subnet). Every device you touch is auto-added as an entity, so attach
+     observations to it by name.
+  3. Prefer specific, reusable facts over transient state. Skip one-off command
+     output; record what will still be true next session.`;
 function createServer(opts = {}) {
   process.title = `Mikrotik MCP Server v${VERSION}`;
   const { names, default: defaultDevice } = listDevices();
   const readOnly = getConfig().readOnly;
   let instructions = names.length > 1 ? INSTRUCTIONS + MULTI_DEVICE_INSTRUCTIONS.replace("{{names}}", names.join(", ")).replace("{{default}}", defaultDevice) : INSTRUCTIONS;
+  if (getConfig().memory.enabled)
+    instructions += MEMORY_INSTRUCTIONS;
   if (!getConfig().disableUpdateCheck) {
     const cached = loadFileCacheSync();
     if (cached) {

package/dist/shared/{cli-cjrk8g04.js → cli-10a2apr1.js}

@@ -4,7 +4,7 @@ import {
   allToolModules,
   moduleCatalog,
   selectToolModules
-} from "./cli-athwegwy.js";
+} from "./cli-365rqpy1.js";
 export {
   selectToolModules,
   moduleCatalog,

package/dist/shared/{cli-athwegwy.js → cli-365rqpy1.js}

@@ -8364,7 +8364,7 @@ var cache = null;
 async function gateway() {
   if (cache)
     return cache;
-  const { moduleCatalog } = await import("./cli-cjrk8g04.js");
+  const { moduleCatalog } = await import("./cli-10a2apr1.js");
   const forIndex = [];
   const byName = new Map;
   for (const mod of moduleCatalog) {
@@ -10158,23 +10158,26 @@ Management access may be partially restricted \u2014 review immediately.`;
 
 // src/tools/firewall-filter.ts
 import { z as z28 } from "zod";
-var isDigits = (s) => /^\d+$/.test(s);
-async function resolveFilterRuleId(ruleId, ctx) {
-  if (/^\d+$/.test(ruleId)) {
-    const id = `*${ruleId}`;
-    const byId = await executeMikrotikCommand(`/ip firewall filter print count-only where .id=${id}`, ctx);
-    if (byId.trim() !== "0")
-      return id;
-    const idsRaw = await executeMikrotikCommand(`:foreach i in=[/ip firewall filter find] do={:put $i}`, ctx);
-    if (isEmpty(idsRaw))
-      return null;
-    const ids = idsRaw.trim().split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
-    const pos = Number.parseInt(ruleId, 10);
-    return pos >= 0 && pos < ids.length ? ids[pos] : null;
-  }
-  const count = await executeMikrotikCommand(`/ip firewall filter print count-only where .id=${ruleId}`, ctx);
-  return count.trim() !== "0" ? ruleId : null;
+
+// src/tools/_resolve-rule-id.ts
+function ruleResolver(scope) {
+  return async function resolveRuleId(ruleId, ctx) {
+    if (/^\d+$/.test(ruleId)) {
+      const idsRaw = await executeMikrotikCommand(`:foreach i in=[${scope} find] do={:put $i}`, ctx);
+      if (isEmpty(idsRaw))
+        return null;
+      const ids = idsRaw.trim().split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+      const pos = Number.parseInt(ruleId, 10);
+      return pos >= 0 && pos < ids.length ? ids[pos] : null;
+    }
+    const count = await executeMikrotikCommand(`${scope} print count-only where .id=${ruleId}`, ctx);
+    return count.trim() !== "0" ? ruleId : null;
+  };
 }
+
+// src/tools/firewall-filter.ts
+var isDigits = (s) => /^\d+$/.test(s);
+var resolveFilterRuleId = ruleResolver("/ip firewall filter");
 async function updateFilterRule(a, ctx) {
   ctx.info(`Updating firewall filter rule: rule_id=${a.rule_id}`);
   const updates = [];
@@ -10561,28 +10564,6 @@ ${results.join(`
 
 // src/tools/firewall-nat.ts
 import { z as z29 } from "zod";
-
-// src/tools/_resolve-rule-id.ts
-function ruleResolver(scope) {
-  return async function resolveRuleId(ruleId, ctx) {
-    if (/^\d+$/.test(ruleId)) {
-      const id = `*${ruleId}`;
-      const byId = await executeMikrotikCommand(`${scope} print count-only where .id=${id}`, ctx);
-      if (byId.trim() !== "0")
-        return id;
-      const idsRaw = await executeMikrotikCommand(`:foreach i in=[${scope} find] do={:put $i}`, ctx);
-      if (isEmpty(idsRaw))
-        return null;
-      const ids = idsRaw.trim().split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
-      const pos = Number.parseInt(ruleId, 10);
-      return pos >= 0 && pos < ids.length ? ids[pos] : null;
-    }
-    const count = await executeMikrotikCommand(`${scope} print count-only where .id=${ruleId}`, ctx);
-    return count.trim() !== "0" ? ruleId : null;
-  };
-}
-
-// src/tools/firewall-nat.ts
 var isDigits2 = (s) => /^\d+$/.test(s);
 var resolveNatRuleId = ruleResolver("/ip firewall nat");
 async function updateNatRule(a, ctx) {
@@ -24967,7 +24948,7 @@ var SERVER_NAME = "mikrotik-mcp";
 var PKG_META = pkg;
 
 // src/core/update-check.ts
-var GITHUB_API = "https://api.github.com/repos/ali-master/mikrotik-mcp/releases/latest";
+var GITHUB_API = "https://api.github.com/repos/mikrotik-mcp/mikrotik-mcp/releases/latest";
 var MEMORY_CACHE_TTL = 15 * 60 * 1000;
 var FILE_CACHE_TTL = 6 * 60 * 60 * 1000;
 var CACHE_PATH = join6(homedir2(), ".mikrotik-mcp", "update-check.json");

package/dist/shared/{library-f5kwsqv2.js → library-ndn9hj45.js}

@@ -8294,7 +8294,7 @@ var cache = null;
 async function gateway() {
   if (cache)
     return cache;
-  const { moduleCatalog } = await import("./library-4fpy49qb.js");
+  const { moduleCatalog } = await import("./library-wbht6e2m.js");
   const forIndex = [];
   const byName = new Map;
   for (const mod of moduleCatalog) {
@@ -10088,23 +10088,26 @@ Management access may be partially restricted \u2014 review immediately.`;
 
 // src/tools/firewall-filter.ts
 import { z as z28 } from "zod";
-var isDigits = (s) => /^\d+$/.test(s);
-async function resolveFilterRuleId(ruleId, ctx) {
-  if (/^\d+$/.test(ruleId)) {
-    const id = `*${ruleId}`;
-    const byId = await executeMikrotikCommand(`/ip firewall filter print count-only where .id=${id}`, ctx);
-    if (byId.trim() !== "0")
-      return id;
-    const idsRaw = await executeMikrotikCommand(`:foreach i in=[/ip firewall filter find] do={:put $i}`, ctx);
-    if (isEmpty(idsRaw))
-      return null;
-    const ids = idsRaw.trim().split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
-    const pos = Number.parseInt(ruleId, 10);
-    return pos >= 0 && pos < ids.length ? ids[pos] : null;
-  }
-  const count = await executeMikrotikCommand(`/ip firewall filter print count-only where .id=${ruleId}`, ctx);
-  return count.trim() !== "0" ? ruleId : null;
+
+// src/tools/_resolve-rule-id.ts
+function ruleResolver(scope) {
+  return async function resolveRuleId(ruleId, ctx) {
+    if (/^\d+$/.test(ruleId)) {
+      const idsRaw = await executeMikrotikCommand(`:foreach i in=[${scope} find] do={:put $i}`, ctx);
+      if (isEmpty(idsRaw))
+        return null;
+      const ids = idsRaw.trim().split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+      const pos = Number.parseInt(ruleId, 10);
+      return pos >= 0 && pos < ids.length ? ids[pos] : null;
+    }
+    const count = await executeMikrotikCommand(`${scope} print count-only where .id=${ruleId}`, ctx);
+    return count.trim() !== "0" ? ruleId : null;
+  };
 }
+
+// src/tools/firewall-filter.ts
+var isDigits = (s) => /^\d+$/.test(s);
+var resolveFilterRuleId = ruleResolver("/ip firewall filter");
 async function updateFilterRule(a, ctx) {
   ctx.info(`Updating firewall filter rule: rule_id=${a.rule_id}`);
   const updates = [];
@@ -10491,28 +10494,6 @@ ${results.join(`
 
 // src/tools/firewall-nat.ts
 import { z as z29 } from "zod";
-
-// src/tools/_resolve-rule-id.ts
-function ruleResolver(scope) {
-  return async function resolveRuleId(ruleId, ctx) {
-    if (/^\d+$/.test(ruleId)) {
-      const id = `*${ruleId}`;
-      const byId = await executeMikrotikCommand(`${scope} print count-only where .id=${id}`, ctx);
-      if (byId.trim() !== "0")
-        return id;
-      const idsRaw = await executeMikrotikCommand(`:foreach i in=[${scope} find] do={:put $i}`, ctx);
-      if (isEmpty(idsRaw))
-        return null;
-      const ids = idsRaw.trim().split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
-      const pos = Number.parseInt(ruleId, 10);
-      return pos >= 0 && pos < ids.length ? ids[pos] : null;
-    }
-    const count = await executeMikrotikCommand(`${scope} print count-only where .id=${ruleId}`, ctx);
-    return count.trim() !== "0" ? ruleId : null;
-  };
-}
-
-// src/tools/firewall-nat.ts
 var isDigits2 = (s) => /^\d+$/.test(s);
 var resolveNatRuleId = ruleResolver("/ip firewall nat");
 async function updateNatRule(a, ctx) {
@@ -24896,7 +24877,7 @@ var SERVER_DESCRIPTION = pkg.description ?? "";
 var SERVER_NAME = "mikrotik-mcp";
 
 // src/core/update-check.ts
-var GITHUB_API = "https://api.github.com/repos/ali-master/mikrotik-mcp/releases/latest";
+var GITHUB_API = "https://api.github.com/repos/mikrotik-mcp/mikrotik-mcp/releases/latest";
 var MEMORY_CACHE_TTL = 15 * 60 * 1000;
 var FILE_CACHE_TTL = 6 * 60 * 60 * 1000;
 var CACHE_PATH = join6(homedir2(), ".mikrotik-mcp", "update-check.json");

package/dist/shared/{library-4fpy49qb.js → library-wbht6e2m.js}

@@ -4,7 +4,7 @@ import {
   allToolModules,
   moduleCatalog,
   selectToolModules
-} from "./library-f5kwsqv2.js";
+} from "./library-ndn9hj45.js";
 export {
   selectToolModules,
   moduleCatalog,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usex/mikrotik-mcp",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "MCP server for MikroTik RouterOS — 660+ tools over SSH for firewall, NAT, routing, DHCP, DNS, WireGuard, wireless, QoS and more.",
   "keywords": [
     "ai",
@@ -12,7 +12,7 @@
   ],
   "homepage": "https://mikrotik-mcp.usestrict.dev",
   "bugs": {
-    "url": "https://github.com/ali-master/mikrotik-mcp/issues"
+    "url": "https://github.com/mikrotik-mcp/mikrotik-mcp/issues"
   },
   "license": "MIT",
   "author": {
@@ -22,7 +22,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/ali-master/mikrotik-mcp.git"
+    "url": "https://github.com/mikrotik-mcp/mikrotik-mcp.git"
   },
   "bin": {
     "mikrotik-mcp": "dist/cli.js"
@@ -50,7 +50,7 @@
     "build": "bunup && chmod +x dist/cli.js && bun run build:ui",
     "build:ui": "bun run --bun scripts/build-ui.ts",
     "dev": "bunup --watch",
-    "prepack": "bunup && chmod +x dist/cli.js && bun run build:ui",
+    "prepack": "bunup && chmod +x dist/cli.js && bun run build:ui && bun run gen",
     "auth-check": "bun run --bun src/cli.ts auth-check",
     "gen:schemas": "bun run --bun scripts/gen-schemas.ts",
     "gen:docs": "bun run --bun scripts/gen-tool-docs.ts",
@@ -117,8 +117,8 @@
   },
   "packageManager": "bun@1.3.14",
   "catalog": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.2",
-    "vite-plus": "0.2.2"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.3",
+    "vite-plus": "0.2.3"
   },
   "changelog": {
     "labels": {
@@ -132,6 +132,6 @@
       "breaking change": "Breaking changes"
     }
   },
-  "logo": "https://raw.githubusercontent.com/ali-master/mikrotik-mcp/master/assets/logo.svg",
-  "logoIcon": "https://raw.githubusercontent.com/ali-master/mikrotik-mcp/master/assets/logo-icon.svg"
+  "logo": "https://raw.githubusercontent.com/mikrotik-mcp/mikrotik-mcp/master/assets/logo.svg",
+  "logoIcon": "https://raw.githubusercontent.com/mikrotik-mcp/mikrotik-mcp/master/assets/logo-icon.svg"
 }

package/schemas/tool-catalog.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.58.0",
+  "version": "4.2.0",
   "generated": "by scripts/gen-schemas.ts — do not edit by hand",
   "toolCount": 794,
   "tools": [
@@ -3477,7 +3477,7 @@
         "idempotentHint": true,
         "openWorldHint": false
       },
-      "description": "Resolves which nexthop RouterOS would use for a given IPv4 destination — answers \"which gateway will this packet take?\" without sending any traffic. Version-aware: uses `/ip route check` on v6, falls back to `/ip route print where dst-address in <dest> active=yes` on v7+ where the check command was removed. Optionally scoped by `routing_table` (v7) / `routing_mark` (v6) for policy-routing table lookups. For listing all known routes use list_routes; for a named-table view use get_routing_table. Returns the resolved nexthop and interface detail.",
+      "description": "Resolves which nexthop RouterOS would use for a given IPv4 destination — answers \"which gateway will this packet take?\" without sending any traffic. Version-aware: uses `/ip route check` on v6, falls back to `/ip route print where <dest> in dst-address active=yes` on v7+ where the check command was removed. Optionally scoped by `routing_table` (v7) / `routing_mark` (v6) for policy-routing table lookups. For listing all known routes use list_routes; for a named-table view use get_routing_table. Returns the resolved nexthop and interface detail.",
       "inputSchema": {
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "type": "object",