Repository navigation
v0.6.0
First release as realtydev/omada-mcp: 78 tools, published to ghcr.io/realtydev/omada-mcp.
Added
- Static route CRUD (
createRoute,updateRoute,deleteRoute) and port forwarding CRUD (createPortForward,updatePortForward,deletePortForward) through the internal web UI API. (@JimmyMultani) - SSID writes (
updateSsid,setSsidEnable) andupdateFirewallAcl. (@JimmyMultani) - IDS/IPS:
getIpsSetting,setIpsSetting. (@JimmyMultani) updateWanPortSetting,listAlerts,getApRadios,setApRadio(dry run and read-back verification),getClientHistory,setLogNotifications. (@JimmyMultani)getServerInforeports the running version, git commit, and build time. (@JimmyMultani)- Module and key-prefix filters for
listEvents. (@JimmyMultani) - Fusion gateway web-session auth via
OMADA_AUTH_MODE=web. (@bullitt186) getGatewayWanStatus: live per-port WAN status.- DHCP DNS servers (
dhcpns,priDns,sndDns), gateway override, and typed custom options oncreateLanNetwork/updateLanNetwork. - Opt-in WAN failover guard (
yarn wan-guard) for Omada Link Backup false-online failures. See docs/wan-guard.md. - Release workflow, Dependabot, contributing guide, security policy, and issue templates.
Fixed
- The server no longer writes a dotenv banner to stdout, which corrupted the MCP stdio transport.
setGatewayWanConnectnow calls theinternet-stateendpoint; the old path did not exist.- Wrong endpoint paths for
getFirmwareDetails,listEvents,listLogs. (@JimmyMultani) - Wrong HTTP verbs for
updateLanNetwork,deleteLanNetwork,updateFirewallSetting. (@JimmyMultani) getPortForwardingStatusUPnP casing andgetSwitchNetworkspagination. (@JimmyMultani)- Internal API errors now include the HTTP status, endpoint, and controller error code. (@JimmyMultani)
startCableTestis now marked destructive.OMADA_TIMEOUTnow really defaults to 30 s; previously requests never timed out unless it was set.- Web-session cookies are redacted from debug logs, and concurrent requests share a single web login.
Changed
- Write tools reject unrecognized fields instead of silently dropping them. (@JimmyMultani) This includes nested
dhcpSettingsVOon LAN networks, so strip read-only fields fromgetLanNetworkListoutput before reusing it. - Package renamed to
@realtydev/omada-mcp; the MCP server identifies asomada-mcp. - Container image moved to
ghcr.io/realtydev/omada-mcp, runs as the non-rootnodeuser, and reports its git commit. - Tooling moved from npm to Yarn 4 (Corepack) with Node 24 pinned in
.nvmrc. (@JimmyMultani)
Container image
docker pull ghcr.io/realtydev/omada-mcp:0.6.0