How sirkirby/unifi-mcp works
UniFi MCP is a suite for AI assistants and applications to operate UniFi Network, Protect, and Access, alongside an independent REST/GraphQL API and optional Cloud Relay. The primary workflow is client discovery and invocation of a domain server’s tools, which interact with UniFi controllers; the API offers an alternative HTTP path for custom applications. Cloud Relay routes remote MCP requests through a Worker to a LAN sidecar and then to local MCP servers. The README documents product-level links; unsampled implementation details are kept broad rather than inferred.
Main entry points: unifi_api API Server · unifi_core UniFi Core Managers · unifi_network_mcp Network Tools · unifi_protect_mcp Protect Tools
Components 19
MCP Servers
- Network Tools
apps/network/src/unifi_network_mcp - Protect Tools
apps/protect/src/unifi_protect_mcp - Access Tools
apps/access/src/unifi_access_mcp
HTTP API
- API Server
apps/api/src/unifi_api - REST Resources
apps/api/src/unifi_api/routes/resources - GraphQL Queries
apps/api/src/unifi_api/graphql - SSE Streams
apps/api/src/unifi_api/routes/streams - Controller Actions
apps/api/src/unifi_api/routes/actions.py - Scoped API Keys
apps/api/src/unifi_api/auth - Administration
apps/api/src/unifi_api/routes/admin
Cloud Relay
- Worker Gateway
apps/worker/worker/src - Durable Object Broker
apps/worker/worker/src/relay-object.ts - Relay Sidecar
packages/unifi-mcp-relay/src/unifi_mcp_relay
Shared Runtime
- UniFi Core Managers
packages/unifi-core/src/unifi_core - MCP Shared Runtime
packages/unifi-mcp-shared/src/unifi_mcp_shared
Other components
- MCP Client
- UniFi Controllers
- Custom Application
- Remote MCP Client
Connections 29
- MCP Client → Network Tools: discovers and invokes
README.md - MCP Client → Protect Tools: discovers and invokes
README.md - MCP Client → Access Tools: discovers and invokes
README.md - Network Tools → UniFi Controllers: manages
README.md - Protect Tools → UniFi Controllers: manages
README.md - Access Tools → UniFi Controllers: manages
README.md - Custom Application → API Server: calls
README.md - API Server → REST Resources: serves
README.md - API Server → GraphQL Queries: serves
README.md - API Server → SSE Streams: serves
README.md - API Server → Controller Actions: routes
README.md - API Server → Scoped API Keys: enforces scopes
README.md - API Server → Administration: provides
README.md - REST Resources → UniFi Core Managers: uses managers
README.md - GraphQL Queries → UniFi Core Managers: uses managers
README.md - Controller Actions → UniFi Core Managers: uses managers
README.md - UniFi Core Managers → UniFi Controllers: operates
README.md - Remote MCP Client → Worker Gateway: sends MCP requests
README.md - Worker Gateway → Durable Object Broker: routes requests
README.md - Worker Gateway → Relay Sidecar: forwards by WebSocket
README.md - Relay Sidecar → Network Tools: forwards over HTTP
README.md - Relay Sidecar → Protect Tools: forwards over HTTP
README.md - Relay Sidecar → Access Tools: forwards over HTTP
README.md - Network Tools → MCP Shared Runtime: uses runtime
apps/network/src/unifi_network_mcp/main.py - Protect Tools → MCP Shared Runtime: uses runtime
apps/protect/src/unifi_protect_mcp/main.py - Access Tools → MCP Shared Runtime: uses runtime
apps/access/src/unifi_access_mcp/main.py - Network Tools → UniFi Core Managers: uses managers
apps/network/src/unifi_network_mcp/tools/traffic_routes.py - Protect Tools → UniFi Core Managers: uses managers
apps/protect/src/unifi_protect_mcp/main.py - Access Tools → UniFi Core Managers: uses managers
apps/access/src/unifi_access_mcp/main.py