Tuya MCP Server
by cabra-lat
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.