JinDaGe - thinqconnect-mcp MCP Details

article

README

🚀 ThinQ Connect MCP Server (Beta)

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

Local Image ThinQ Connect MCP Demo

🚀 快速开始

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

✨ 主要特性

设备列表查询
检索所有已注册的LG ThinQ设备列表。
设备状态监控
获取特定设备的实时状态信息。
设备控制
执行每个设备配置文件中定义的控制命令。
（例如，打开/关闭空调、设置温度等）
设备控制能力查询
提供每个设备可控制属性、方法的详细信息。

📦 安装指南

准备用于ThinQ Open API调用的个人访问令牌
验证你的ThinQ账户的国家代码。你可以在国家代码部分找到它。
Python 3.11或更高版本
安装uv - 一个用于Python项目的快速Python包安装器和解析器
MCP客户端（Claude Desktop等）

📚 详细文档

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

你可以使用的提示示例如下：

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

📄 工具参考

可用工具

get_device_list
- 描述：检索连接到ThinQ Connect平台的所有设备列表
- 参数：无
- 返回：包含连接设备列表信息的字符串
get_device_available_controls
- 描述：检索特定设备的可用控制命令和参数信息
- 参数：device_type（字符串），device_id（字符串）
- 返回：包含设备控制命令和参数信息的字符串
get_device_status
- 描述：检索特定设备的状态信息
- 参数：device_id（字符串）
- 返回：包含设备状态信息的字符串
post_device_control
- 描述：向ThinQ Connect平台上的特定设备发送控制命令，以更改其设置或状态
- 参数：device_type（字符串），device_id（字符串），control_method（字符串），control_params（字典）
- 返回：包含设备控制结果消息的字符串

thinqconnect-mcp