中

Управляйте устройствами умного дома Xiaomi с помощью помощников искусственного интеллекта с помощью протокола Model Context Protocol (MCP).

Работает с Claude Code, Claude Desktop, Cursor и любым MCP-совместимым клиентом.

Особенности

Device Discovery — автоматически найдите все устройства в своей учетной записи Xiaomi Мониторинг состояния — состояние мощности, яркость, температура, влажность, аккумулятор, состояние блокировки Управление устройством — Включение/выключение, регулировка яркости, цветовой температуры, целевой температуры XiaoAi Speaker — музыка для воспроизведения/паузы, TTS, управление громкостью, голосовые команды QR Code Login — сканирование с помощью приложения Mi Home без пароля ** Настройка нулевых зависимостей** — всего два файла на Python без установки pip

Быстрый старт

Предпосылки

Python 3.10+

• uv (рекомендуется) или pip Приложение Mi Home на вашем телефоне (для входа в QR-код)

###1, вход

QR-код откроется в вашем браузере. Сканируйте его с помощью приложения Mi Home (Profile → значок сканирования в правом верхнем углу).

При этом они сохраняют свои свойства в [1].

###2 Подключайтесь к коду Клода

Вот так! Теперь вы можете общаться со своими устройствами:

«Повернуть на лампу» «Какая температура в комнате?» «Дверь заперта?» «Установить яркость до 50%»

Xiaomi Home MCP Server

中文文档

Control your Xiaomi smart home devices through AI assistants via the Model Context Protocol (MCP).

Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Features

• Device Discovery — Automatically find all devices in your Xiaomi account
• Status Monitoring — Read power state, brightness, temperature, humidity, battery, lock status
• Device Control — Turn on/off, adjust brightness, color temperature, target temperature
• XiaoAi Speaker — Play/pause music, TTS, volume control, voice commands
• QR Code Login — Scan with Mi Home app, no password needed
• Zero Dependencies Setup — Just two Python files, no pip install required

Quick Start

Prerequisites

• Python 3.10+
• uv (recommended) or pip
• Mi Home app on your phone (for QR code login)

1. Login

uv run --script login.py

A QR code will open in your browser. Scan it with the Mi Home app (Profile → Scan icon in top-right corner).

Tokens are saved to ~/.xiaomi-mcp/tokens.json with 600 permissions.

2. Connect to Claude Code

claude mcp add xiaomi-home -- uv run --script /path/to/mcp_server.py

That’s it! Now you can talk to your devices:

“Turn on the lamp” “What’s the room temperature?” “Is the door locked?” “Set brightness to 50%” “Play some music”

2a. Connect to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "xiaomi-home": {
      "command": "uv",
      "args": ["run", "--script", "/path/to/mcp_server.py"]
    }
  }
}

Available Tools

Supported Devices

The server auto-detects device types by model prefix: