Thinqconnect MCP

🚀 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（字典）
   • 返回：包含設備控制結果消息的字符串