Thinqconnect MCP

🚀 ThinQ Connect MCP Server (Beta)

このサーバーは、LG ThinQデバイス用の公式MCP（Model Context Protocol）サーバーです。LG ThinQ APIとPython Open SDKをベースに構築され、さまざまなLG ThinQデバイスの状態監視、デバイス制御、プロファイル情報などの統合制御機能を提供します。MCPの接続方法はstdioです。

📚 目次

• 主な機能
• 前提条件
• クイックスタート
• 詳細な使用方法
• ツールリファレンス

✨ 主な機能

• デバイスリストの照会
  登録されているすべてのLG ThinQデバイスのリストを取得します。
• デバイスの状態監視
  特定のデバイスのリアルタイムの状態情報を取得します。
• デバイスの制御
  各デバイスのプロファイルで定義された制御コマンドを実行します。
  （例：エアコンの電源のオン/オフ、温度の設定など）
• デバイスの制御機能の照会
  各デバイスの制御可能なプロパティ、メソッド情報に関する詳細情報を提供します。

📋 前提条件

1. ThinQ Open API呼び出し用のパーソナルアクセストークンを準備します。
2. あなたのThinQアカウントの国コードを確認します。国コードセクションで確認できます。
3. Python 3.11以上
4. uvをインストールします - Pythonプロジェクト用の高速Pythonパッケージインストーラーとリゾルバー
5. MCPクライアント（Claude Desktopなど）

🚀 クイックスタート

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

📚 詳細な使用方法

クイックスタートセクションで示されたように設定ファイルを設定した後、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 (辞書)
   • 戻り値: デバイスの制御結果メッセージを含む文字列