Govee MCP Server

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:

1. Holen Sie sich Ihren API-Schlüssel vom Govee Developer Portal

2. 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.