设备控制协议服务器

LG ThinQ设备的官方MCP服务器,提供状态监控、设备控制和配置文件信息等集成控制功能。

  • by thinq-connect
  • Python
  • 本地部署
  • 33 星标
  • 更新于
在 GitHub 查看 thinq-connect/thinqconnect-mcp

使用说明

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平台的所有设备的列表
    • 参数:无
    • 返回:包含已连接设备列表信息的字符串
  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(字典)
    • 返回:包含设备控制结果消息的字符串