UniFi MCP Server

Implementation Reference

• src/tools/protect.js:132-182 (handler)

  The main handler function for the 'get_cameras_status_summary' tool. It fetches the list of cameras from the UniFi host, processes them to compute summary statistics (total count, online/offline status, recording status, privacy mode, model breakdown), compiles a list of camera details, and returns a JSON-formatted text response.

  handler: async ({ hostId }) => {
    const camerasResponse = await unifi.listCameras(hostId);
    const cameras = camerasResponse.data || [];
  
    const summary = {
      total: cameras.length,
      online: 0,
      offline: 0,
      recording: 0,
      privacyMode: 0,
      byModel: {},
      cameras: []
    };
  
    cameras.forEach(cam => {
      // Count by status
      if (cam.state === 'CONNECTED' || cam.isConnected) {
        summary.online++;
      } else {
        summary.offline++;
      }
  
      // Count recording
      if (cam.isRecording) {
        summary.recording++;
      }
  
      // Count privacy mode
      if (cam.privacyMode) {
        summary.privacyMode++;
      }
  
      // Count by model
      const model = cam.model || 'Unknown';
      summary.byModel[model] = (summary.byModel[model] || 0) + 1;
  
      // Add camera info
      summary.cameras.push({
        id: cam.id,
        name: cam.name,
        model: cam.model,
        state: cam.state,
        isRecording: cam.isRecording,
        privacyMode: cam.privacyMode
      });
    });
  
    return {
      content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }]
    };
  }

• src/tools/protect.js:129-131 (schema)

  Zod schema defining the input parameters for the tool: requires a 'hostId' string.

  schema: z.object({
    hostId: z.string().describe('The host ID')
  }),

• src/server.js:31-31 (registration)

  The protectTools module, which exports the 'get_cameras_status_summary' tool definition (including handler and schema), is registered here using registerToolsFromModule. This makes the tool available in the MCP server.

  registerToolsFromModule(protectTools);