Smart Bulb MCP Server
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 % und100 % 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 buildDie 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 devKonfiguration 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äßig55443für Yeelight und9999fü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):truezum Einschalten,falsezum Ausschalten.
5. set_bulb_brightness
Setzt die Helligkeit / Deckkraft der Glühne.
Argumente:
brightness(number, erforderlich): Werte von1bis100.
6. set_bulb_color_rgb
Setzt die Farbe der Glühne mithilfe von RGBWerten.
Argumenten:
r(number, erforderlich): Rotwert0-255.g(number, erforderlich): Grünwert0-255.b(number, erforderlich): Blauwert0-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
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"Führen Sie den Client aus:
Interaktiver CLI-Modus:
npm run clientDies ö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"
Modell anpassen (optional): Standardmäßig wird
gpt-4o-miniverwendet. Sie können es ändern, indem Sie die UmgebungsvariableOPENAI_MODELsetzen:$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 toolsconnect_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Yeelight device discovery, state, control, and scene execution.
Control and query Heiman smart home devices: lights, AC, curtains, climate, logs and scenes.
Control a Loxone Miniserver smart home: lights, blinds, climate, scenes and energy.
Yeelight home metadata and guarded management workflows.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables control of smart lights through MQTT messaging protocol, supporting operations like turning lights on/off and adjusting brightness levels from 0-100.-
- AlicenseAqualityDmaintenanceMCP server for controlling WiZ smart lights locally via UDP: discover bulbs, power control, color, temperature, and scenes.10MIT
- FlicenseNot gradedqualityDmaintenanceEnables control of Yeelight smart lights over local LAN, supporting on/off, brightness, color, temperature, and auto discovery.-
- AlicenseAqualityCmaintenanceEnables local network control of Tuya and Smart Life smart home devices without cloud round-trips, including power, brightness, color, and raw datapoint operations.9MIT