Skip to main content
Glama

Smart Bulb MCP Server

Ein Model Context Protocol (MCP)-Server, erstellt mit Node.js und TypeScript, der smarte Glühbirnen über IP steuert. Er unterstützt:

  • Mock/simulierte Glühbirne: For lokales Testen und Entwicklung oh Re physische Hardware.

  • Yeelight/Xiaomi-Glühbirne: Verwendet den Standard-TCP-Port 55443 (JSON-RPC-Protokoll zur lokalen Steuerung), um echte physische smarte Glühbirnen zu steueren.

Features

  • Verbindung per IP: Verbinden Sie sich dynamisch mit verschiedenen Glühbirnen in Ihrem lokalen Netzwerk.

  • Ein-/Ausschaltung: Schalten Sie die Glühbirne ein oder aus.

  • **He * Helligkeit/Deckkraft: Stelen Sie die Helligkeit / Intensität der Glühbirne zwischen 1 % und 100 % ein.

  • Farbsteuerung: Setzen Sie Farben über RGB-Koordinaten oder hexadezimale Farbcodes.

  • Statusabfragen: Rufen Sie den aktuellen Zustand der Glühne in Expertezeit ab.


Related MCP server: wiz-light-mcp

Geting Started (Translate: Erste Schritte)

1. Den Server bauen

Instalieren Sie zuerst die Abhängigkeiten und kompilieren Sie die TypeScript-Dateien:

# Install dependencies
npm install

# Compile the TypeScript files
npm run build

Die Werden in das Verzeichnis dist/ ausgegeben.

2. Ausfüren / Enticklung

Sie können den Server direkt über Standard-E/A (Stdio) ausführen:

# Run the built JS
npm start

# Compile and run in development mode
npm run dev

Konfiguration mit MCP-Clients

Um diesen Server mit einem M-CP-Cient (z. B. Claude D or C) zu verwenden, fügen Sie die Server-Konfiguration in Ih. Konfigurationsatei ein.

Für Claude Desktop

Bearbeiten Sie Ihre claude_desktop_config.json (normalerweise unter Windows in %APP %APPDATA%\Claudeor unter macOS unter~/Library/Application Support/Claude`):

{
  "mcpServers": {
    "smart-bulb": {
      "command": "node",
      "args": ["D:/Palwinder/mcp-server-bulb/dist/index.js"]
    }
  }
}

Hinweis: Ersetzen Sie D:/Project/mcp-server-bulb/dist/index.js durch den absoluten Pfad zu dist/index.js auf Ihrem Rechner.


"Exposed MCP Tools"

Sobald der Server verbunden ist, hat das Host-LLM Zugriff auf die folgenden Tools:

1.connect_bulb

Stellt eine Verbindung zu einer Glühbirne her, die unter einer angegebenen IP-Adresse erreichbar ist.

  • Argumente:

    • ip (string, erforderlich): IP-Adresse (z. B. "192.168.1.15" oder "127.0.0.1").

    • type (enum ["mock", "yeelight"], Standard: "mock"): Treibertyp. Verwenden Sie "mock", um die Serverfunktionen ohne physische Hardware zu testen, oder "yeelight" für echte Yeelight-Glühbirnen.

    • port (number, optional): Der zu verwendende Port. Standardmäßig 55443 für Yeelight und 9999 für Mock.

2. disconnect_bulb

Trennt die Verbindung zur aktuell verbundenen Glühbirne.

  • Argumente: Keine.

3. get_bulb_state

Ruft den Verbindungsstatus, den Ein-/Ausschaltzustand, die Helligkeits-/Deckkraft in Prozent und die RGB-Farbe ab.

  • Argumente: Keine.

4. set_bulb_power

Schaltet die Glühne ein oder aus.

  • Argumente:

    • power (boolean, erforderlich): true zum Einschalten, false zum Ausschalten.

5. set_bulb_brightness

Setzt die Helligkeit / Deckkraft der Glühne.

  • Argumente:

    • brightness (number, erforderlich): Werte von 1 bis 100.

6. set_bulb_color_rgb

Setzt die Farbe der Glühne mithilfe von RGBWerten.

  • Argumenten:

    • r (number, erforderlich): Rotwert 0 - 255.

    • g (number, erforderlich): Grünwert 0 - 255.

    • b (number, erforderlich): Blauwert 0 - 255.

7. set_bulb_color_hex

Setzt die Farbe der Glühne mithilfe eines Hex-Farbcodes.

  • Argumente:

    • hex (string, erforderlich): Hex-Code (z. B. "#FF0000" oder "00FF00").


OpenAI-Verbindungsclient

Wir haben einen Client-Wrapper in src/openai-client.tserstellt, mit dem Sie Prompts direkt an OpenAI übergeben können. OpenAI hat die MCP-Tools vollauton autonom auf, um Aktionen an Ihrer smarte Glühne auszuführen.

Einrichtung und Ausführung des Clients

  1. Legen Sie Ihren OpenAI-API-Schlüssel fest: Unter Windows (PowerShell):

    $env:OPENAI_API_KEY="your-actual-api-key"

    Unter macOS/Linux (Bash):

    export OPENAI_API_KEY="your-actual-api-key"
  2. Führen Sie den Client aus:

    • Interaktiver CLI-Modus:

      npm run client

      Dies öffnet eine Shell-Eingabeaufforderung. Versuchen Sie beispielsweise Folgendes einzugeben:

      Verbinden Sie sich mit der Mock-Glühne, schalten Sie es ein, setzen Sie die Helligkeit auf 80 % und die Farbe auf Gelb.

    • Einmaliger Befehlsmodus: Übergeben Sie Ihren Prompt direkt als Argumente:

      npm run client -- "connect to the mock bulb, turn it on, and set color to blue"
  3. Modell anpassen (optional): Standardmäßig wird gpt-4o-mini verwendet. Sie können es ändern, indem Sie die Umgebungsvariable OPENAI_MODEL setzen:

    $env:OPENAI_MODEL="gpt-4o"

Entwicklerdetails & Architektur

Das Projekt hat eine modulare Architektur:

  • src/bulb/interface.ts: Definiert den gemeinsamen Vertrag (ISmartBulb) und die Zustandsstruktur (BulbState).

  • src/bulb/mock.ts: Eine simulierte Glühbirneninstanz, die Netzwerklatenz und Zustandsänderungen im Speicher simuliert.

  • src/bulb/yeelight.ts: Implementiert einen zeilenbasierten TCP-Roh-Puffer-Parser, um JSON-RPC-Pakete direkt von physischen Yeelight-WLAN-Glühbirnen zu senden und zu empfangen – ohne Third-Party-SDK-Abhängigkeiten.

  • src/index.ts: Konfiguriert und bindet die @modelcontextprotocol/server-Tools ein und verwaltet Verbindungszustände und Validierungsschemata.

  • src/openai-client.ts: Startet den MCP-Server als Unterprozess, lädt alle Tools dynamisch, stellt sie als OpenAI Functions bereit und übernimmt die mehrstufige Dialog-Tool-Ausführungsschleife.


Erstellt von Palwinder Singh

Available Tools

7 tools
connect_bulbA

Connect to a smart bulb at a given IP address. Supports both real Yeelight bulbs and mock bulbs for testing.

Inputs: ip (required), port, type.

disconnect_bulbA

Disconnect from the currently active smart bulb.

Inputs: no named parameters.

get_bulb_stateA

Retrieve the current state (power status, brightness/opacity, color) of the connected smart bulb.

Inputs: no named parameters.

set_bulb_brightnessA

Set the brightness (intensity/opacity) of the connected smart bulb.

Inputs: brightness (required).

set_bulb_color_hexA

Set the color of the connected smart bulb using a hexadecimal color code (e.g. '#FF0000' or '00FF00').

Inputs: hex (required).

set_bulb_color_rgbB

Set the color of the connected smart bulb using RGB values (0-255).

Inputs: b (required), g (required), r (required).

set_bulb_powerB

Turn the connected smart bulb on or off.

Inputs: power (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation4/5

    Tools have distinct purposes: connect, disconnect, state retrieval, and setting power, brightness, and color. The only overlap is between set_bulb_color_rgb and set_bulb_color_hex, which serve the same function with different input formats, but their descriptions clearly differentiate them, causing minimal confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., connect_bulb, get_bulb_state, set_bulb_power). The naming style is uniform with snake_case and clear action-target structure, making the API predictable and easy to navigate.

    Tool Count5/5

    With 7 tools, the set is well-scoped for a smart bulb control server. Each tool addresses a core operation (connection, state, power, brightness, color) without redundant or excessive entries, fitting comfortably within the ideal 3-15 range.

    Completeness4/5

    The server covers essential smart bulb operations: connection management, state retrieval, power, brightness, and color control. A minor gap is the lack of color temperature or scene settings, which are common on smart bulbs, but the core workflows are fully supported and no critical dead ends exist.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for controlling WiZ smart lights locally via UDP: discover bulbs, power control, color, temperature, and scenes.
      10
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables local network control of Tuya and Smart Life smart home devices without cloud round-trips, including power, brightness, color, and raw datapoint operations.
      9
      MIT