fibaro_control_rgb_light

Instructions

Implementation Reference

• src/index.ts:506-547 (handler)

  The handler for the fibaro_control_rgb_light tool. It handles turning the device on/off, setting RGB color from color name using getColorRGB, and adjusting brightness, composing multiple operations into one tool call.

  case 'fibaro_control_rgb_light': {
    if (!this.fibaroClient) {
      throw new Error('Not connected to Fibaro HC3. Please check your configuration and restart the MCP server.');
    }
    const deviceId = args?.id as number;
    const action = args?.action as string;
    const colorName = args?.color_name as string;
    const brightness = args?.brightness as number;
  
    const results = [];
  
    // First, turn on/off the light
    if (action === 'on') {
      await this.fibaroClient.turnOnDevice(deviceId);
      results.push(`Turned on device ${deviceId}`);
    } else if (action === 'off') {
      await this.fibaroClient.turnOffDevice(deviceId);
      results.push(`Turned off device ${deviceId}`);
    }
  
    // Set color if specified
    if (colorName && action === 'on') {
      const rgb = getColorRGB(colorName);
      await this.fibaroClient.setColor(deviceId, rgb.r, rgb.g, rgb.b, 0);
      results.push(`Set color to ${colorName} RGB(${rgb.r},${rgb.g},${rgb.b})`);
    }
  
    // Set brightness if specified
    if (brightness !== undefined && action === 'on') {
      await this.fibaroClient.setBrightness(deviceId, brightness);
      results.push(`Set brightness to ${brightness}%`);
    }
  
    return {
      content: [
        {
          type: 'text',
          text: `Device ${deviceId}: ${results.join(', ')}`,
        },
      ],
    };
  }

• src/index.ts:275-299 (schema)

  Input schema defining parameters for the fibaro_control_rgb_light tool: device id (required), action (on/off required), optional color_name and brightness.

  inputSchema: {
    type: 'object',
    properties: {
      id: {
        type: 'number',
        description: 'Device ID',
      },
      action: {
        type: 'string',
        enum: ['on', 'off'],
        description: 'Turn light on or off',
      },
      color_name: {
        type: 'string',
        description: 'Color name (e.g., "red", "green", "blue", "xanh lá", "tím")',
      },
      brightness: {
        type: 'number',
        description: 'Brightness level (0-100), optional',
        minimum: 0,
        maximum: 100,
      },
    },
    required: ['id', 'action'],
  },

• src/index.ts:272-300 (registration)

  Registration of the fibaro_control_rgb_light tool in the ListTools response, including name, description, and input schema.

  {
    name: 'fibaro_control_rgb_light',
    description: 'Complete control for RGB lights: turn on/off, set color, and brightness in one command. Use this when user wants to control multiple aspects of an RGB light at once (e.g., "turn on light 5 red color at 50% brightness").',
    inputSchema: {
      type: 'object',
      properties: {
        id: {
          type: 'number',
          description: 'Device ID',
        },
        action: {
          type: 'string',
          enum: ['on', 'off'],
          description: 'Turn light on or off',
        },
        color_name: {
          type: 'string',
          description: 'Color name (e.g., "red", "green", "blue", "xanh lá", "tím")',
        },
        brightness: {
          type: 'number',
          description: 'Brightness level (0-100), optional',
          minimum: 0,
          maximum: 100,
        },
      },
      required: ['id', 'action'],
    },
  },

• src/index.ts:12-41 (helper)

  Supporting utility function that converts color names (including Vietnamese) to RGB values, used in the tool handler for color setting.

  function getColorRGB(colorName: string): { r: number; g: number; b: number } {
    const colors: { [key: string]: { r: number; g: number; b: number } } = {
      'red': { r: 255, g: 0, b: 0 },
      'green': { r: 0, g: 255, b: 0 },
      'blue': { r: 0, g: 0, b: 255 },
      'yellow': { r: 255, g: 255, b: 0 },
      'purple': { r: 128, g: 0, b: 128 },
      'pink': { r: 255, g: 192, b: 203 },
      'orange': { r: 255, g: 165, b: 0 },
      'cyan': { r: 0, g: 255, b: 255 },
      'magenta': { r: 255, g: 0, b: 255 },
      'white': { r: 255, g: 255, b: 255 },
      'black': { r: 0, g: 0, b: 0 },
      'lime': { r: 50, g: 205, b: 50 },
      'violet': { r: 238, g: 130, b: 238 },
      // Vietnamese color names
      'đỏ': { r: 255, g: 0, b: 0 },
      'xanh lá': { r: 0, g: 255, b: 0 },
      'xanh dương': { r: 0, g: 0, b: 255 },
      'vàng': { r: 255, g: 255, b: 0 },
      'tím': { r: 128, g: 0, b: 128 },
      'hồng': { r: 255, g: 192, b: 203 },
      'cam': { r: 255, g: 165, b: 0 },
      'trắng': { r: 255, g: 255, b: 255 },
      'đen': { r: 0, g: 0, b: 0 }
    };
    
    const normalizedName = colorName.toLowerCase().trim();
    return colors[normalizedName] || { r: 255, g: 255, b: 255 }; // default to white
  }