Govee MCP Server

Name: Govee MCP Server
Author: mathd

Schmiedeabzeichen

Ein MCP-Server zur Steuerung von Govee-LED-Geräten über die Govee-API.

Aufstellen

Umgebungsvariablen

Erstellen Sie im Stammverzeichnis eine .env Datei mit den folgenden Variablen:

GOVEE_API_KEY=your_api_key_here GOVEE_DEVICE_ID=your_device_id_here GOVEE_SKU=your_device_sku_here

So erhalten Sie diese Werte:

Holen Sie sich Ihren API-Schlüssel vom Govee Developer Portal
Verwenden Sie die Govee Home-App, um Ihre Geräte-ID und SKU zu finden

Related MCP server: OpenHue MCP Server

Installation

Installation über Smithery

So installieren Sie den Govee MCP-Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @mathd/govee_mcp_server --client claude

Manuelle Installation

# Install with pip pip install . # For development (includes test dependencies) pip install -e ".[test]"

Verwendung

MCP-Server

Der MCP-Server bietet Tools zur Steuerung von Govee-Geräten über das Model Context Protocol. Er kann mit Cline oder anderen MCP-Clients verwendet werden.

Verfügbare Werkzeuge:

turn_on_off : Schaltet die LED ein oder aus
set_color : Stellen Sie die LED-Farbe mit RGB-Werten ein
set_brightness : Stellen Sie die Helligkeitsstufe der LED ein

Befehlszeilenschnittstelle

Zur direkten Steuerung von Govee-Geräten steht eine CLI zur Verfügung:

# Turn device on/off govee-cli power on govee-cli power off # Set color using RGB values (0-255) govee-cli color 255 0 0 # Red govee-cli color 0 255 0 # Green govee-cli color 0 0 255 # Blue # Set brightness (0-100) govee-cli brightness 50

Führen Sie govee-cli --help aus, um die vollständige Befehlsdokumentation zu erhalten.

Entwicklung

Ausführen von Tests

So führen Sie die Testsuite aus:

# Install test dependencies pip install -e ".[test]" # Run all tests pytest tests/ # Run specific test files pytest tests/test_server.py # Server tests (mocked API calls) pytest tests/test_cli.py # CLI tests (real API calls) # Run tests with verbose output pytest tests/ -v

Hinweis: Die CLI-Tests führen echte API-Aufrufe an Ihr Govee-Gerät aus und steuern es tatsächlich. Stellen Sie sicher, dass Ihr Gerät eingeschaltet und verbunden ist, bevor Sie diese Tests ausführen.

Projektstruktur

. ├── src/govee_mcp_server/ │ ├── __init__.py │ ├── server.py # MCP server implementation │ └── cli.py # Command-line interface ├── tests/ │ ├── test_server.py # Server tests (with mocked API) │ └── test_cli.py # CLI tests (real API calls) └── pyproject.toml # Project configuration

Testabdeckung

Servertests umfassen:
- Umgebungsinitialisierung
- Govee API-Clientmethoden
- Servertools und -dienstprogramme
- Fehlerbehandlung
CLI-Tests führen reale Integrationstests durch, indem sie tatsächliche API-Aufrufe zur Steuerung Ihres Govee-Geräts ausführen.