🚀 ThinQ Connect MCP Server (Beta)

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

🚀 快速开始

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设备列表。

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

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

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

📦 安装指南

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

📚 详细文档

在按照快速开始部分设置好配置文件后，你可以在与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（字典）
   • 返回：包含设备控制结果消息的字符串