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: Philips Hue MCP Service

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