Servidor MCP para Lavadora LG

Un servidor MCP que permite a un asistente de IA supervisar y controlar una lavadora LG ThinQ a través de la API oficial ThinQ Connect de LG.

Se comunica con la API REST directamente a través de HTTP (sin SDK de LG). Su Token de Acceso Personal (PAT) se utiliza como token de portador.

Cómo funciona la API (la versión corta)

• Autenticación: Authorization: Bearer <PAT>. Sin flujo OAuth.

• Región: su código de país elige el servidor. India (IN) → https://api-kic.lgthinq.com.

• Cada solicitud también envía x-country, x-client-id (un UUID4 que usted elige), x-api-key (una clave pública), x-message-id (nuevo por solicitud), x-service-phase: OP.

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

Herramientas expuestas

⚠️ La mayoría de las lavadoras LG solo aceptan un START remoto cuando la máquina está físicamente configurada en "Inicio remoto" con un ciclo ya cargado. La API reanuda/inicia un ciclo preseleccionado; normalmente no puede elegir un programa de lavado desde cero.

Configuración

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

Ejecutarlo

La configuración se lee de las variables de entorno (THINQ_PAT, THINQ_COUNTRY, THINQ_CLIENT_ID). El servidor habla MCP a través de stdio.

THINQ_PAT=xxx THINQ_COUNTRY=IN uv run washer-mcp

Conectar con Claude Desktop / Claude Code

Añada a su configuración de MCP (por ejemplo, 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"
      }
    }
  }
}

Para Claude Code específicamente:

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

Prueba manual rápida (sin necesidad de cliente MCP)

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()))"