Tuya MCP Server
by cabra-lat
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Uses Python packages for interacting with Tuya smart devices, allowing control of device states, color settings, brightness, temperature, and modes through a command-line interface.
tuyactl
This project provides a command-line interface (tuyactl
) for controlling Tuya devices. It interacts with a separate Tuya Server (I'm still thinking a better way of doing that).
Requirements
- uv: A fast and modern Python package installer and runner. Install it by following the instructions on the uv documentation site.
- Tuya Local Keys: You will need the local keys for your Tuya devices. Follow the tinytuya setup wizard to obtain these.
Quick Start
- Install
uv
:Follow the official installation instructions on the uv documentation site. The recommended method is to use the standalone installer, which you can download and run with the following command:Copy - Obtain Tuya Local Keys:Follow the tinytuya setup wizard to get the local keys for your Tuya devices. Place the resulting
snapshot.json
file in your home directory (~
). You can customize the location of this file using environment variables (see below). - Run the server:Copy
- Run
tuyactl
:To see the available commands and options, run:To execute a specific command, use the following syntax:CopyReplaceCopy<command>
with one of the available commands:list
,on
,off
,color
,brightness
,temperature
,mode
,music
. Use the `--
help` option to see the available options for each command.
Copy
Configuration
snapshot.json
Location: You can customize the location of thesnapshot.json
file (containing your Tuya device keys) using environment va riables. (Details on this to be added later).
This server cannot be installed
Provides a note storage system with a custom URI scheme and includes tools for adding notes and generating summaries for Tuya devices.