【技术文档摘要】：

ThinQ Connect MCP 服务器（测试版）

这是LG ThinQ设备的官方MCP（模型上下文协议）服务器。 该服务器提供了对各种LG ThinQ设备的集成控制能力，包括状态监控、设备控制以及设备配置信息，基于LG ThinQ API和Python开放SDK构建。MCP连接方式是标准输入输出（stdio）。

目录

• 特性
• 前提条件
• 快速开始
• 详细用法
• 工具参考

特性

• 设备列表查询
  获取所有已注册的LG ThinQ设备列表。

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

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

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

---

前提条件

1. 准备一个个人访问令牌，用于调用ThinQ开放API。
2. 验证您的ThinQ账户的国家代码。您可以在国家代码部分找到它。
3. Python 3.11或更高版本
4. 安装uv - 适用于Python项目的快速安装程序和解析器
5. MCP客户端（如Claude Desktop等）

---

快速开始

Claude Desktop

打开配置文件，并添加ThinQ Connect MCP配置。

• 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"
      }
    }
  }
}

---

详细用法

在按照快速开始部分设置好配置文件后，您可以在与Claude的对话中直接使用ThinQ Connect MCP服务器。

您可以使用的提示示例：

• "请提供所有设备的列表"
• "请检查机器人吸尘器设备的状态"
• "请将空调设备的温度设置为24度"

---

工具参考

可用工具

1. get_device_list

   • 描述：获取连接到ThinQ Connect平台的所有设备列表
   • 参数：无
   • 返回值：包含连接设备列表信息的字符串

2. get_device_available_controls

   • 描述：获取特定设备可用的控制命令及其参数信息
   • 参数：device_type (字符串), device_id (字符串)
   • 返回值：包含设备控制命令及其参数信息的字符串

3. get_device_status

   • 描述：获取特定设备的状态信息
   • 参数：device_id (字符串)
   • 返回值：包含设备状态信息的字符串

4. post_device_control

   • 描述：向ThinQ Connect平台上的特定设备发送控制命令以更改其设置或状态
   • 参数：device_type (字符串), device_id (字符串), control_method (字符串), control_params (字典)
   • 返回值：包含设备控制结果消息的字符串