OpenHue MCP Server

Instructions

Implementation Reference

• src/index.ts:228-246 (handler)

  The handler function for the 'get-lights' tool. Constructs a 'get light' OpenHue CLI command with optional lightId or room filters, appends --json, executes it using executeHueCommand, and returns the result as text content.

  case "get-lights": {
    let command = "get light";
    if (args?.lightId) {
      command += ` "${args.lightId}"`;
    }
    if (args?.room) {
      command += ` --room "${args.room}"`;
    }
    command += " --json";
    const result = await executeHueCommand(command);
    return {
      content: [
        {
          type: "text",
          text: result,
        },
      ],
    };
  }

• src/index.ts:85-97 (schema)

  JSON input schema for the 'get-lights' tool, defining optional 'lightId' and 'room' string parameters.

  inputSchema: {
    type: "object",
    properties: {
      lightId: {
        type: "string",
        description: "Optional light ID or name to get specific light details",
      },
      room: {
        type: "string",
        description: "Optional room name to filter lights",
      },
    },
  },

• src/index.ts:82-98 (registration)

  Tool registration in the listTools handler, specifying name, description, and inputSchema for 'get-lights'.

  {
    name: "get-lights",
    description: "List all Hue lights or get details for a specific light",
    inputSchema: {
      type: "object",
      properties: {
        lightId: {
          type: "string",
          description: "Optional light ID or name to get specific light details",
        },
        room: {
          type: "string",
          description: "Optional room name to filter lights",
        },
      },
    },
  },

• src/index.ts:64-76 (helper)

  Helper function used by 'get-lights' handler to execute OpenHue CLI commands via Docker container, capturing stdout or throwing errors.

  async function executeHueCommand(command: string): Promise<string> {
    try {
      const { stdout, stderr } = await execAsync(buildDockerCommand(command));
      if (stderr) {
        console.error("Command error:", stderr);
        throw new Error(stderr);
      }
      return stdout;
    } catch (error) {
      console.error("Execution error:", error);
      throw error;
    }
  }

• src/index.ts:22-25 (helper)

  Helper to build Docker command for running openhue/cli with mounted config, used indirectly by get-lights via executeHueCommand.

  const buildDockerCommand = (command: string) => {
    const configPath = getConfigPath();
    return `docker run -v "${configPath}:/.openhue" --rm openhue/cli ${command}`;
  };