LG Washer MCP Server

AIアシスタントがLGの公式ThinQ Connect APIを通じてLG ThinQ洗濯機を監視・制御できるようにするMCPサーバーです。

REST APIと直接HTTPで通信します（LG SDKは不要）。Personal Access Token (PAT) がベアラートークンとして使用されます。

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洗濯機は、機械が物理的に「リモートスタート」に設定され、サイクルがすでにロードされている場合にのみ、リモート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()))"