UniFi MCP Server

Implementation Reference

• src/tools/devices.js:115-135 (handler)

  Handler function that normalizes the input MAC address, retrieves all devices using unifi.listAllDevices(), filters devices matching the MAC, and returns a JSON response with search details and matches.

  handler: async ({ mac }) => {
    const normalizedMac = mac.toLowerCase().replace(/[:-]/g, '');
    const allDevices = await unifi.listAllDevices();
    const devices = allDevices.data || [];
  
    const matches = devices.filter(d => {
      const deviceMac = (d.mac || '').toLowerCase().replace(/[:-]/g, '');
      return deviceMac === normalizedMac || deviceMac.includes(normalizedMac);
    });
  
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          searchMac: mac,
          matchCount: matches.length,
          matches
        }, null, 2)
      }]
    };
  }

• src/tools/devices.js:112-114 (schema)

  Zod schema defining the input parameter 'mac' as a string for the tool.

  schema: z.object({
    mac: z.string().describe('The MAC address to search for')
  }),

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

  Registers the deviceTools module, including the find_device_by_mac tool, by calling registerToolsFromModule which invokes server.tool for each tool in the module.

  registerToolsFromModule(deviceTools);

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

  Import of the deviceTools module containing the find_device_by_mac tool definition.

  import { deviceTools } from './tools/devices.js';