CodeLightAI - Philips Smart Bulb Controller

CodeLightAI is a Node.js-based application that provides a server for controlling a Philips Smart Bulb. It uses the Model Context Protocol (MCP) to expose tools for interacting with the bulb, such as turning it on/off, changing its color, and pulsing it in Morse code.

Prerequisites

• Node.js: Version 18 or higher.

• pnpm: Version 10.11.0 or higher (used as the package manager).

• A Philips Smart Bulb connected to the same network as the application.

  - pywizlight: Wiz Ligt API Documentation, which made this project possible.

  Features

  • Turn On/Off the Bulb: Easily switch the bulb on or off.
  • Change Bulb Color: Set the bulb's RGB color, brightness, and optional color temperature.
  • Pulse in Morse Code: Make the bulb pulse to display a Morse code message.
  • MCP Integration: Uses the Model Context Protocol for seamless tool integration.

  Prerequisites

  • Node.js: Version 18 or higher.
  • pnpm: Version 10.11.0 or higher (used as the package manager).
  • A Philips Smart Bulb connected to the same network as the application.

  Installation

  1. Clone the repository:

     git clone https://github.com/abhishekr77/codeLightAi.git 
     

  2. Install dependencies:

     pnpm install
     

  3. Build the project:

     pnpm build
     

  Configuration

  The application communicates with the Philips Smart Bulb using UDP. Ensure the following configurations in src/service.ts are correct:

  const BULB_IP = "192.168.1.7"; // Replace with your bulb's IP address 
    const PORT = 38899; // Default port for Philips Smart Bulb
  

  Usage

  1. Start the server:

     pnpm start
     

  2. The server will run on standard input/output (stdio) and expose the following tools:
     • Pulse Bulb: Pulses the bulb in a Morse code pattern.
     • Change Bulb Color: Changes the bulb's RGB color, brightness, and optional temperature.
     • Turn Off Bulb: Turns the bulb off.
     • Turn On Bulb: Turns the bulb on.

  Tools Overview

  Pulse Bulb

  • Description: Pulses the bulb to display a Morse code message.
  • Parameters:
    • message (string): The message to display in Morse code.
    • unitDuration (number): Duration of a single Morse code unit in milliseconds.

  Change Bulb Color

  • Description: Changes the bulb's RGB color, brightness, and optional temperature.
  • Parameters:
    • r (number): Red intensity (0-255).
    • g (number): Green intensity (0-255).
    • b (number): Blue intensity (0-255).
    • dimming (number): Brightness percentage (0-100).
    • temp (number | null): Optional color temperature in kelvins.

  Turn Off Bulb

  • Description: Turns the bulb off.
  • Parameters: None.

  Turn On Bulb

  • Description: Turns the bulb on.
  • Parameters: None.

  Development

  To make changes to the code:

  1. Edit the TypeScript files in the src/ directory.
  2. Rebuild the project:

     pnpm build
     

  Contributing

  Contributions are welcome! Feel free to open issues or submit pull requests.

  License

  This project is licensed under the ISC License.