ThinQ Connect MCP Server

ThinQ Connect MCP服务器（测试版）

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

目录

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

特性

• 设备列表查询\

检索所有已注册的LG ThinQ设备的列表。

• 设备状态监控\

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

• 设备控制\

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

• 设备控制能力查询\

提供每个设备的可控属性、方法信息的详细信息。

______________________________________________________________________

先决条件

1. 准备一份 个人访问令牌 用于ThinQ Open API调用
2. 验证您的ThinQ帐户的国家代码。你可以在 国家代码 部分。
3. Python 3.11或更高版本
4. 安装 紫外线 -Python项目的快速Python包安装程序和解析器
5. MCP客户端（克劳德桌面等）

______________________________________________________________________

快速开始

克劳德桌面

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

• macOS：~/库/应用程序支持/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平台的所有设备的列表 - 参数：无 - 返回：包含已连接设备列表信息的字符串

1. get_device_available_controls

- 描述：检索特定设备的可用控制命令和参数信息 - 参数：device_type（字符串），device_id（字符串） - 返回：包含设备控制命令和参数信息的字符串

1. get_device_status

- 描述：检索特定设备的状态信息 - 参数：device_id（字符串） - 返回：包含设备状态信息的字符串

1. post_device_control

- 说明：向ThinQ Connect平台上的特定设备发送控制命令，以更改其设置或状态 - 参数：device_type（字符串），device_id（字符串）、control_method（字符串）和control_params（字典） - 返回：包含设备控制结果消息的字符串