Mcp Server Tuya

mcp-server-tuya

AI アシスタント（Claude、ChatGPT、Copilot、Cursor など）から、Tuya / Smart Life のスマートホームデバイスを操作できる Model Context Protocol (MCP) サーバーです。

特長

• デバイスを完全に制御する 10 個のツール（オン／オフ、明るさ、色、温度、カスタムコマンド）
• デバイス名の解決 — ID の代わりに「リビングのライト」のような分かりやすい名前を使用できます
• インテリジェントなキャッシュ — API 呼び出しを減らすための TTL を設定できます
• すべての Tuya リージョンに対応 — EU、US、CN、IN
• 設定ファイル不要 — 環境変数で認証情報を指定します
• Claude Desktop、ChatGPT、GitHub Copilot、Cursor、Windsurf、Cline、および MCP 互換のあらゆるクライアントで動作します

クイックスタート

1. Tuya の認証情報を取得する

1. Tuya IoT Platform にアクセスしてアカウントを作成します
2. Cloud Project を作成します（リージョンと「Smart Home」業種を選択します）
3. Devices > Link Tuya App Account に移動し、Smart Life / Tuya Smart アプリを連携します
4. プロジェクトの概要から Access ID と Access Secret をコピーします

2. MCP クライアントを設定する

{
  "mcpServers": {
    "tuya": {
      "command": "uvx",
      "args": ["mcp-server-tuya"],
      "env": {
        "TUYA_ACCESS_ID": "your_access_id",
        "TUYA_ACCESS_KEY": "your_access_key",
        "TUYA_API_ENDPOINT": "https://openapi.tuyaeu.com"
      }
    }
  }
}

claude mcp add tuya -- uvx mcp-server-tuya

export TUYA_ACCESS_ID="your_access_id"
export TUYA_ACCESS_KEY="your_access_key"
export TUYA_API_ENDPOINT="https://openapi.tuyaeu.com"

{
  "mcpServers": {
    "tuya": {
      "command": "uvx",
      "args": ["mcp-server-tuya"],
      "env": {
        "TUYA_ACCESS_ID": "your_access_id",
        "TUYA_ACCESS_KEY": "your_access_key",
        "TUYA_API_ENDPOINT": "https://openapi.tuyaeu.com"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "tuya": {
        "command": "uvx",
        "args": ["mcp-server-tuya"],
        "env": {
          "TUYA_ACCESS_ID": "your_access_id",
          "TUYA_ACCESS_KEY": "your_access_key",
          "TUYA_API_ENDPOINT": "https://openapi.tuyaeu.com"
        }
      }
    }
  }
}

3. クライアントを再起動する

これで完了です！AI アシスタントに、次のように尋ねてみましょう：

• 「すべてのデバイスを一覧表示して」
• 「リビングのライトを消して」
• 「寝室のライトの明るさを 50% に設定して」
• 「キッチンの温度は？」
• 「すべて消して」

インストール

uvx を使用する（推奨）

インストールは不要です。uvx が直接実行します：

uvx mcp-server-tuya

pip を使用する

pip install mcp-server-tuya

GitHub から

pip install git+https://github.com/juanmartinsantos/mcp-server-tuya.git

利用可能なツール

すべてのツールは、デバイス ID または デバイス名（例："Living Room Light"）を受け付けます。

環境変数

リージョン別 API エンドポイント

ローカル開発

# Clone the repository
git clone https://github.com/juanmartinsantos/mcp-server-tuya.git
cd mcp-server-tuya

# Create virtual environment
python -m venv .venv
.venv\Scripts\activate  # Windows
# source .venv/bin/activate  # macOS/Linux

# Install in editable mode
pip install -e ".[dev]"

# Copy and configure environment
cp .env.example .env
# Edit .env with your credentials

# Run the server
mcp-server-tuya
# or: python -m mcp_server_tuya

トラブルシューティング

「TUYA_ACCESS_ID environment variable is required」

認証情報が設定されていません。MCP クライアントの設定に env セクションを追加してください。

「API error: permission deny」

Tuya Cloud プロジェクトに適切な権限がありません。Tuya IoT Platform > プロジェクト > Service API に移動し、IoT Core と Smart Home API を有効にしてください。

「Device not found」

デバイス名が一致していません。まず tuya_list_devices を使って、デバイスの正確な名前を確認してください。

サーバーが起動しない

uv がインストールされていることを確認してください。次のコマンドでインストールできます。

# Windows
winget install --id=astral-sh.uv

# macOS
brew install uv

ライセンス

MIT License — 詳細は LICENSE を参照してください。

クレジット

• FastMCP — Python 向け MCP サーバーフレームワーク
• tuya-connector-python — Tuya Cloud 公式 SDK
• Model Context Protocol — Anthropic 提供