这是LG ThinQ设备官方的MCP（模型上下文协议）服务器。 该服务器提供集成控制功能，包括状态监控、设备控制和配置文件信息，适用于基于LG ThinQ API和Python Open SDK构建的各种LG ThinQ设备。MCP连接方式为stdio。

目录

• 特色
• 先决条件
• 快速入门
• 详细使用情况
• 工具参考

特色

• 设备列表查询 检索所有注册的LG ThinQ设备列表。

• 设备状态监控 获取特定设备的实时状态信息。

• 设备控制 执行每个设备配置文件中定义的控制命令。 （例如，开关空调、设定温度等）

• 设备控制能力查询 提供关于可控特性的详细信息，以及每个设备的方法信息。

---

先修条件

1. 为 ThinQ Open API 调用准备个人访问令牌
2. 核实你ThinQ账户的国家代码。你可以在国家代码部分找到。
3. Python 3.11 或更高版本
4. 安装uv——一款快速的Python套件安装器和解析器，用于Python项目
5. MCP客户端（Claude Desktop等）

---

ThinQ Connect MCP Server (Beta)

This is the official MCP (Model Context Protocol) server for LG ThinQ devices. This server provides integrated control capabilities including status monitoring, device control, and profile information for various LG ThinQ devices, built on the LG ThinQ API and Python Open SDK. MCP connection method is stdio.

Table of Contents

• Features
• Prerequisites
• Quick Start
• Detailed Usage
• Tool Reference

Features

• Device List Query
  Retrieve a list of all registered LG ThinQ devices.

• Device Status Monitoring
  Get real-time status information for specific devices.

• Device Control
  Execute control commands defined in each device’s profile.
  (e.g., turn air conditioner on/off, set temperature, etc.)

• Device Control Capabilities Query
  Provide detailed information about controllable properties, methods information for each device.

---

Prerequisites

1. Prepare a Personal Access Token for ThinQ Open API calls
2. Verify your ThinQ account’s country code. You can find it in the Country Codes section.
3. Python 3.11 or higher
4. Install uv - A fast Python package installer and resolver for Python projects
5. MCP client (Claude Desktop, etc.)

---

Quick Start

Claude Desktop

Open up the configuration file, and add ThinQ Connect MCP config.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "thinqconnect-mcp": {
      "command": "uvx",
      "args": [
        "thinqconnect-mcp"
      ],
      "env": {
          "THINQ_PAT": "your_personal_access_token_here",
          "THINQ_COUNTRY": "your_country_code_here"
      }
    }
  }
}

---

Detailed Usage

After setting up the configuration file as shown in the Quick Start section, you can use the ThinQ Connect MCP Server directly in your conversations with Claude.

Examples of prompts you can use:

• “Please provide a list of all devices”
• “Please check the status of the robot vacuum device”
• “Please set the temperature of the air conditioner device to 24 degrees”

---

Tool Reference

Available Tools

1. get_device_list

   • Description: Retrieves a list of all devices connected to the ThinQ Connect platform
   • Parameters: None
   • Returns: String containing connected device list information

2. get_device_available_controls

   • Description: Retrieves available control commands and parameter information for a specific device