LG Washer MCP Server

MCP 서버는 AI 어시스턴트가 LG 공식 ThinQ Connect API를 통해 LG ThinQ 세탁기를 모니터링하고 제어할 수 있게 해줍니다.

REST API와 HTTP로 직접 통신합니다(LG SDK 불필요). **Personal Access Token (PAT)**이 bearer 토큰으로 사용됩니다.

API 작동 방식(간단히)

• 인증: Authorization: Bearer <PAT>. OAuth 플로우 없음.

• 지역: 국가 코드가 서버를 결정합니다. 인도(IN) → https://api-kic.lgthinq.com.

• 모든 요청에는 x-country, x-client-id(직접 선택하는 UUID4), x-api-key(공개 키), x-message-id(요청마다 새로 생성), x-service-phase: OP도 함께 전송됩니다.

• 엔드포인트: GET /devices, GET /devices/{id}/profile, GET /devices/{id}/state, POST /devices/{id}/control.

제공되는 도구

⚠️ 대부분의 LG 세탁기는 기기가 물리적으로 "Remote Start" 상태이고 코스가 이미 선택되어 있을 때만 원격 START를 허용합니다. API는 미리 선택된 코스를 재개/시작하며, 일반적으로 세탁 프로그램을 처음부터 선택할 수는 없습니다.

설정

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

실행

구성은 환경 변수(THINQ_PAT, THINQ_COUNTRY, THINQ_CLIENT_ID)에서 읽습니다. 서버는 stdio를 통해 MCP로 통신합니다.

THINQ_PAT=xxx THINQ_COUNTRY=IN uv run washer-mcp

Claude Desktop / Claude Code에 연결

MCP 구성에 추가하세요(예: 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"
      }
    }
  }
}

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

빠른 수동 테스트(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()))"