ruckus-mcp

MCP server for Ruckus Unleashed (tested on R500/R600, built-in Embedthis-Appweb web server). Uses aioruckus to talk to the controller's AJAX API.

Tools

Monitoring

Management

Related MCP server: UniFi Network MCP Server

Setup

git clone <this-repo> ruckus-mcp && cd ruckus-mcp
python3 -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env       # fill in RUCKUS_HOST/USER/PASS, MCP_SECRET
uvicorn server:app --host 0.0.0.0 --port 8003

Systemd unit example: deploy/ruckus-mcp.service.

Security model

• Auth is an Authorization: Bearer $MCP_SECRET header on /mcp. Unlike the other servers in this line-up, the Authorization header is always required here — even without MCP_SECRET set, you still need to send Authorization: Bearer (empty value). It's recommended to always set MCP_SECRET.

• /.well-known/oauth-authorization-server + /oauth/authorize + /oauth/token are a compatible stub for claude.ai custom connectors, which don't support a static API key — only full OAuth 2.1 or no auth at all. The actual protection is the Bearer token on /mcp.

• redirect_uri in /oauth/authorize is checked against an allowlist (claude.ai, anthropic.com, console.anthropic.com, localhost).

• Important if you extend get_system_info: aioruckus.get_system_info(SystemStat.ALL) returns the controller's entire raw config, including the local admin password in plaintext, TR-069/CWMP passwords, and cloud keys (AWS SNS, PubNub). _clean_system_info() in the code whitelists only the safe fields — if you add new fields to this tool's output, whitelist them explicitly, don't widen it via **info or similar.

• TLS verification to the controller is disabled (ssl.CERT_NONE, SECLEVEL=0) — typical Unleashed firmware uses self-signed certificates with a weak key. This is an intentional tradeoff for a trusted local network; don't point RUCKUS_HOST at anything outside your LAN/VPN.

• Outbound transport: the server itself does not terminate TLS — it listens on plain HTTP. If it's reachable beyond localhost/a trusted LAN (and especially if you're connecting it as a custom connector in claude.ai, where HTTPS is required), put TLS termination in front of it: Cloudflare Tunnel, Tailscale Funnel, nginx/Caddy + Let's Encrypt, etc. Without that, the Bearer token (MCP_SECRET) in the Authorization header goes out in plaintext. (This is a separate concern from the TLS verification to the controller described above.)

Requirements

• Ruckus Unleashed (web UI on 443/8443).

• Python 3.11+.

License

MIT — see LICENSE.