midea-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MIDEA_MCP_DATA_DIR | No | Data directory path (default: ./data) | ./data |
| MIDEA_MCP_MASTER_KEY | No | URL-safe base64 encoded 32-byte master key for encrypting tokens/keys |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_devicesA | List registered logical air conditioners, bindings, routes, and cached state. |
| get_deviceA | Get one AC by its midea-mcp internal UUID, including capabilities. |
| refresh_deviceA | Read the actual AC state through LAN and update the local cache. |
| set_device_stateA | Set AC desired state once; never retry an uncertain LAN write via Cloud. |
| discover_lan_devicesB | Scan LAN ACs and reconcile identities; target may be an IP/broadcast address. |
| diagnose_deviceC | Check bindings, encrypted credential presence, route policy, and LAN read. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: retrieving device info, refreshing state, listing devices, setting state, discovering LAN devices, and diagnosing. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern using lowercase snake_case (get_device, refresh_device, list_devices, set_device_state, discover_lan_devices, diagnose_device).
With 6 tools covering listing, retrieval, state refresh, state setting, discovery, and diagnostics, the set is well-scoped for managing Midea air conditioners without being excessive or insufficient.
The tool set covers core operations: listing, reading, refreshing, setting state, discovering, and diagnosing. Minor gaps like device deletion or cloud-only refresh are absent but not critical for the intended domain.