Overview
The UniFi MCP Server is designed to allow MCP-capable clients (e.g., Claude Desktop) to directly interact with UniFi Site Manager and UniFi Dream Machine, making the available telemetry usable in conversational contexts. It exposes a set of MCP tools to access and interpret UniFi telemetry, including mcpGetClientDetails, mcpGetClients, mcpGetISPMetrics, mcpGetDateAndTime, and mcpPing. The schemas and usage for each tool are documented in their respective files, and test coverage is provided for observation and validation. The project is released under the MIT License and is a personal project with no affiliation to Ubiquiti. A Dockerfile is included and has been tested with Podman, making containerized deployment the recommended approach. API keys are described in sample.env, and a sample JSON configuration demonstrates how to run the service via Podman. The project notes that the MCP server is in early beta and may evolve with UniFi SM and Network APIs as they mature. The README also emphasizes a straightforward container-based workflow for deployment.
Features
mcpGetClientDetails
Retrieve details for a specific MCP client connected to UniFi Site Manager; tool schemas are documented in the corresponding tool file.
mcpGetClients
Fetch the list of MCP clients known to the UniFi Site Manager and local UniFi router environment.
mcpGetISPMetrics
Obtain ISP-related metrics exposed by UniFi ISP data via the MCP server.
mcpGetDateAndTime
Return the current date and time information from the server environment.
mcpPing
Perform a health check to verify connectivity to UniFi Site Manager and Network APIs.
Who Is This For?
- MCP clients:Direct access to UniFi telemetry via conversational interfaces for MCP clients.
- Developers:Integrate telemetry tools with apps, scripts, or dashboards for provisioning and monitoring UniFi deployments.
