LG Waschmaschinen-MCP-Server

Ein MCP-Server, der es einem KI-Assistenten ermöglicht, eine LG ThinQ-Waschmaschine über die offizielle ThinQ Connect-API von LG zu überwachen und zu steuern.

Er kommuniziert direkt über HTTP mit der REST-API (ohne LG SDK). Ihr Personal Access Token (PAT) wird als Bearer-Token verwendet.

So funktioniert die API (die Kurzversion)

• Auth: Authorization: Bearer <PAT>. Kein OAuth-Ablauf.

• Region: Ihr Ländercode bestimmt den Server. Indien (IN) → https://api-kic.lgthinq.com.

• Jede Anfrage sendet außerdem x-country, x-client-id (eine UUID4 Ihrer Wahl), x-api-key (einen öffentlichen Schlüssel), x-message-id (frisch pro Anfrage), x-service-phase: OP.

• Endpunkte: GET /devices, GET /devices/{id}/profile, GET /devices/{id}/state, POST /devices/{id}/control.

Verfügbare Tools

⚠️ Die meisten LG-Waschmaschinen akzeptieren einen Remote-START nur, wenn das Gerät physisch auf „Remote Start" eingestellt ist und bereits ein Programm geladen ist. Die API setzt ein vorausgewähltes Programm fort/startet es; sie kann normalerweise kein Waschprogramm von Grund auf auswählen.

Einrichtung

uv sync
cp .env.example .env   # then edit .env with your PAT

Ausführen

Die Konfiguration wird aus Umgebungsvariablen gelesen (THINQ_PAT, THINQ_COUNTRY, THINQ_CLIENT_ID). Der Server spricht MCP über stdio.

THINQ_PAT=xxx THINQ_COUNTRY=IN uv run washer-mcp

In Claude Desktop / Claude Code einbinden

Fügen Sie Folgendes zu Ihrer MCP-Konfiguration hinzu (z. B. claude_desktop_config.json):

{
  "mcpServers": {
    "lg-washer": {
      "command": "uv",
      "args": ["--directory", "/Users/sushmanagaraj/c_drive/Coding/LG", "run", "washer-mcp"],
      "env": {
        "THINQ_PAT": "your-pat-here",
        "THINQ_COUNTRY": "IN",
        "THINQ_CLIENT_ID": "your-uuid4-here"
      }
    }
  }
}

Speziell für Claude Code:

claude mcp add lg-washer --env THINQ_PAT=xxx --env THINQ_COUNTRY=IN -- uv --directory /Users/sushmanagaraj/c_drive/Coding/LG run washer-mcp

Schneller manueller Test (kein MCP-Client erforderlich)

uv run python -c "import asyncio, os; from washer_mcp.thinq_client import ThinQClient; \
print(asyncio.run(ThinQClient(os.environ['THINQ_PAT'],'IN',os.environ.get('THINQ_CLIENT_ID','test-id')).list_devices()))"