npm - @owine/unifi-network-mcp - Versions diffs - 0.9.0 → 2.0.0 - Mend

@owine/unifi-network-mcp 0.9.0 → 2.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 (8) hide show

package/README.md +3 -19
package/dist/config.js +2 -2
package/dist/tools/devices.js +4 -4
package/dist/tools/dns-policies.js +8 -8
package/dist/tools/firewall.js +21 -0
package/dist/tools/supporting.js +4 -4
package/dist/tools/wifi.js +7 -7
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -15,15 +15,7 @@ An MCP (Model Context Protocol) server that exposes the UniFi Network Integratio
 Add to Claude Code with a single command — no clone or build needed:
 ```bash
-claude mcp add-json unifi-network '{
-  "command": "npx",
-  "args": ["-y", "@owine/unifi-network-mcp"],
-  "env": {
-    "UNIFI_NETWORK_HOST": "192.168.1.1",
-    "UNIFI_NETWORK_API_KEY": "your-api-key",
-    "UNIFI_NETWORK_VERIFY_SSL": "false"
-  }
-}' -s user
+claude mcp add-json unifi-network '{"command":"npx","args":["-y","@owine/unifi-network-mcp@latest"],"env":{"UNIFI_NETWORK_HOST":"192.168.1.1","UNIFI_NETWORK_API_KEY":"your-api-key","UNIFI_NETWORK_VERIFY_SSL":"false"}}' -s user
 ```
 Use `-s user` for global availability across all projects, or `-s project` for the current project only.
@@ -42,15 +34,7 @@ npm run build
 Then add to Claude Code:
 ```bash
-claude mcp add-json unifi-network '{
-  "command": "node",
-  "args": ["/path/to/unifi-network-mcp/dist/index.js"],
-  "env": {
-    "UNIFI_NETWORK_HOST": "192.168.1.1",
-    "UNIFI_NETWORK_API_KEY": "your-api-key",
-    "UNIFI_NETWORK_VERIFY_SSL": "false"
-  }
-}' -s user
+claude mcp add-json unifi-network '{"command":"node","args":["/path/to/unifi-network-mcp/dist/index.js"],"env":{"UNIFI_NETWORK_HOST":"192.168.1.1","UNIFI_NETWORK_API_KEY":"your-api-key","UNIFI_NETWORK_VERIFY_SSL":"false"}}' -s user
 ```
 ### Environment Variables
@@ -71,7 +55,7 @@ Alternatively, add to your `~/.claude.json` under the top-level `"mcpServers"` k
   "mcpServers": {
     "unifi-network": {
       "command": "npx",
-      "args": ["-y", "@owine/unifi-network-mcp"],
+      "args": ["-y", "@owine/unifi-network-mcp@latest"],
       "env": {
         "UNIFI_NETWORK_HOST": "192.168.1.1",
         "UNIFI_NETWORK_API_KEY": "your-api-key",

package/dist/config.js CHANGED Viewed

@@ -11,7 +11,7 @@ const configSchema = zod_1.z.object({
         .describe("Verify SSL certificates"),
     readOnly: zod_1.z
         .boolean()
-        .default(false)
+        .default(true)
         .describe("When true, only read-only tools are registered"),
 });
 function loadConfig() {
@@ -19,7 +19,7 @@ function loadConfig() {
         host: process.env.UNIFI_NETWORK_HOST,
         apiKey: process.env.UNIFI_NETWORK_API_KEY,
         verifySsl: process.env.UNIFI_NETWORK_VERIFY_SSL?.toLowerCase() !== "false",
-        readOnly: process.env.UNIFI_NETWORK_READ_ONLY?.toLowerCase() === "true",
+        readOnly: process.env.UNIFI_NETWORK_READ_ONLY?.toLowerCase() !== "false",
     });
     if (!result.success) {
         console.error("Configuration error:", result.error.format());

package/dist/tools/devices.js CHANGED Viewed

@@ -49,7 +49,7 @@ function registerDeviceTools(server, client, readOnly = false) {
         deviceId: zod_1.z.string().describe("Device ID"),
     }, safety_js_1.READ_ONLY, async ({ siteId, deviceId }) => {
         try {
-            const data = await client.get(`/sites/${siteId}/devices/${deviceId}/statistics`);
+            const data = await client.get(`/sites/${siteId}/devices/${deviceId}/statistics/latest`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -74,7 +74,7 @@ function registerDeviceTools(server, client, readOnly = false) {
     }, safety_js_1.READ_ONLY, async ({ offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
-            const data = await client.get(`/devices/pending${query}`);
+            const data = await client.get(`/pending-devices${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -145,9 +145,9 @@ function registerDeviceTools(server, client, readOnly = false) {
     }, safety_js_1.WRITE, async ({ siteId, deviceId, portIdx, dryRun }) => {
         const body = { action: "POWER_CYCLE" };
         if (dryRun)
-            return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/devices/${deviceId}/ports/${portIdx}/actions`, body);
+            return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/devices/${deviceId}/interfaces/ports/${portIdx}/actions`, body);
         try {
-            const data = await client.post(`/sites/${siteId}/devices/${deviceId}/ports/${portIdx}/actions`, body);
+            const data = await client.post(`/sites/${siteId}/devices/${deviceId}/interfaces/ports/${portIdx}/actions`, body);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {

package/dist/tools/dns-policies.js CHANGED Viewed

@@ -28,7 +28,7 @@ function registerDnsPolicyTools(server, client, readOnly = false) {
     }, safety_js_1.READ_ONLY, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
-            const data = await client.get(`/sites/${siteId}/dns-policies${query}`);
+            const data = await client.get(`/sites/${siteId}/dns/policies${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -40,7 +40,7 @@ function registerDnsPolicyTools(server, client, readOnly = false) {
         dnsPolicyId: zod_1.z.string().describe("DNS policy ID"),
     }, safety_js_1.READ_ONLY, async ({ siteId, dnsPolicyId }) => {
         try {
-            const data = await client.get(`/sites/${siteId}/dns-policies/${dnsPolicyId}`);
+            const data = await client.get(`/sites/${siteId}/dns/policies/${dnsPolicyId}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -61,8 +61,8 @@ function registerDnsPolicyTools(server, client, readOnly = false) {
     }, safety_js_1.WRITE_NOT_IDEMPOTENT, async ({ siteId, policy, dryRun }) => {
         try {
             if (dryRun)
-                return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/dns-policies`, policy);
-            const data = await client.post(`/sites/${siteId}/dns-policies`, policy);
+                return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/dns/policies`, policy);
+            const data = await client.post(`/sites/${siteId}/dns/policies`, policy);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -82,8 +82,8 @@ function registerDnsPolicyTools(server, client, readOnly = false) {
     }, safety_js_1.WRITE, async ({ siteId, dnsPolicyId, policy, dryRun }) => {
         try {
             if (dryRun)
-                return (0, safety_js_1.formatDryRun)("PUT", `/sites/${siteId}/dns-policies/${dnsPolicyId}`, policy);
-            const data = await client.put(`/sites/${siteId}/dns-policies/${dnsPolicyId}`, policy);
+                return (0, safety_js_1.formatDryRun)("PUT", `/sites/${siteId}/dns/policies/${dnsPolicyId}`, policy);
+            const data = await client.put(`/sites/${siteId}/dns/policies/${dnsPolicyId}`, policy);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -107,8 +107,8 @@ function registerDnsPolicyTools(server, client, readOnly = false) {
             return guard;
         try {
             if (dryRun)
-                return (0, safety_js_1.formatDryRun)("DELETE", `/sites/${siteId}/dns-policies/${dnsPolicyId}`, {});
-            const data = await client.delete(`/sites/${siteId}/dns-policies/${dnsPolicyId}`);
+                return (0, safety_js_1.formatDryRun)("DELETE", `/sites/${siteId}/dns/policies/${dnsPolicyId}`, {});
+            const data = await client.delete(`/sites/${siteId}/dns/policies/${dnsPolicyId}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {

package/dist/tools/firewall.js CHANGED Viewed

@@ -217,6 +217,27 @@ function registerFirewallTools(server, client, readOnly = false) {
             return (0, responses_js_1.formatError)(err);
         }
     });
+    server.tool("unifi_patch_firewall_policy", "Partially update a firewall policy (e.g. toggle logging)", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        firewallPolicyId: zod_1.z.string().describe("Firewall policy ID"),
+        policy: zod_1.z
+            .record(zod_1.z.string(), zod_1.z.unknown())
+            .describe("Partial firewall policy fields to update (e.g. { loggingEnabled: true })"),
+        dryRun: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Preview this action without executing it"),
+    }, safety_js_1.WRITE, async ({ siteId, firewallPolicyId, policy, dryRun }) => {
+        try {
+            if (dryRun)
+                return (0, safety_js_1.formatDryRun)("PATCH", `/sites/${siteId}/firewall/policies/${firewallPolicyId}`, policy);
+            const data = await client.patch(`/sites/${siteId}/firewall/policies/${firewallPolicyId}`, policy);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
     server.tool("unifi_delete_firewall_policy", "DESTRUCTIVE: Delete a firewall policy", {
         siteId: zod_1.z.string().describe("Site ID"),
         firewallPolicyId: zod_1.z.string().describe("Firewall policy ID"),

package/dist/tools/supporting.js CHANGED Viewed

@@ -24,7 +24,7 @@ function registerSupportingTools(server, client) {
     }, safety_js_1.READ_ONLY, async ({ siteId, offset, limit }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit });
-            const data = await client.get(`/sites/${siteId}/wan-interfaces${query}`);
+            const data = await client.get(`/sites/${siteId}/wans${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -53,7 +53,7 @@ function registerSupportingTools(server, client) {
     }, safety_js_1.READ_ONLY, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
-            const data = await client.get(`/sites/${siteId}/vpn-tunnels${query}`);
+            const data = await client.get(`/sites/${siteId}/vpn/site-to-site-tunnels${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -82,7 +82,7 @@ function registerSupportingTools(server, client) {
     }, safety_js_1.READ_ONLY, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
-            const data = await client.get(`/sites/${siteId}/vpn-servers${query}`);
+            const data = await client.get(`/sites/${siteId}/vpn/servers${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -111,7 +111,7 @@ function registerSupportingTools(server, client) {
     }, safety_js_1.READ_ONLY, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
-            const data = await client.get(`/sites/${siteId}/radius-profiles${query}`);
+            const data = await client.get(`/sites/${siteId}/radius/profiles${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {

package/dist/tools/wifi.js CHANGED Viewed

@@ -28,7 +28,7 @@ function registerWifiTools(server, client, readOnly = false) {
     }, safety_js_1.READ_ONLY, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
-            const data = await client.get(`/sites/${siteId}/wifi${query}`);
+            const data = await client.get(`/sites/${siteId}/wifi/broadcasts${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -40,7 +40,7 @@ function registerWifiTools(server, client, readOnly = false) {
         wifiBroadcastId: zod_1.z.string().describe("WiFi Broadcast ID"),
     }, safety_js_1.READ_ONLY, async ({ siteId, wifiBroadcastId }) => {
         try {
-            const data = await client.get(`/sites/${siteId}/wifi/${wifiBroadcastId}`);
+            const data = await client.get(`/sites/${siteId}/wifi/broadcasts/${wifiBroadcastId}`);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -70,8 +70,8 @@ function registerWifiTools(server, client, readOnly = false) {
                 broadcastingFrequenciesGHz: broadcastingFrequenciesGHz.map(Number),
             };
             if (dryRun)
-                return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/wifi`, body);
-            const data = await client.post(`/sites/${siteId}/wifi`, body);
+                return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/wifi/broadcasts`, body);
+            const data = await client.post(`/sites/${siteId}/wifi/broadcasts`, body);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -95,8 +95,8 @@ function registerWifiTools(server, client, readOnly = false) {
             if (enabled !== undefined)
                 body.enabled = enabled;
             if (dryRun)
-                return (0, safety_js_1.formatDryRun)("PUT", `/sites/${siteId}/wifi/${wifiBroadcastId}`, body);
-            const data = await client.put(`/sites/${siteId}/wifi/${wifiBroadcastId}`, body);
+                return (0, safety_js_1.formatDryRun)("PUT", `/sites/${siteId}/wifi/broadcasts/${wifiBroadcastId}`, body);
+            const data = await client.put(`/sites/${siteId}/wifi/broadcasts/${wifiBroadcastId}`, body);
             return (0, responses_js_1.formatSuccess)(data);
         }
         catch (err) {
@@ -124,7 +124,7 @@ function registerWifiTools(server, client, readOnly = false) {
         if (guard)
             return guard;
         try {
-            let path = `/sites/${siteId}/wifi/${wifiBroadcastId}`;
+            let path = `/sites/${siteId}/wifi/broadcasts/${wifiBroadcastId}`;
             if (force) {
                 path += "?force=true";
             }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@owine/unifi-network-mcp",
-  "version": "0.9.0",
+  "version": "2.0.0",
   "description": "MCP server for the UniFi Network API",
   "main": "dist/index.js",
   "bin": {