English한국어

Model Context Protocol (MCP)을 통해 AI Assistants를 통해 Xiaomi 스마트 홈 장치를 제어하십시오.

Claude Code, Claude Desktop, Cursor 및 MCP 호환 클라이언트와 함께 작동합니다.

특징

• Device Discovery - Xiaomi 계정에서 모든 장치를 자동으로 찾습니다.
• Status Monitoring - 전력 상태, 밝기, 온도, 습도, 배터리, 잠금 상태 읽기
• **장치 제어 ** - 켜기 / 끄기, 밝기, 색온도, 대상 온도 조정
• **XiaoAi 스피커 ** - 재생 / 일시 음악, TTS, 볼륨 제어, 음성 명령
• **QR 코드 로그인 ** - Mi Home 앱과 스캔, 암호 없음
• Zero Dependencies Setup — 그냥 두 파이썬 파일, 아니 pip install required

빠른 시작

# 필수품

• 파이썬 3.10+
• uv (권장) 또는 pip
• 휴대폰의 Mi Home 앱 ( QR 코드 로그인)

##1 로그인

QR 코드가 브라우저에서 열립니다. Mi Home 앱(Profile → Scan icon in top-right corner)로 스캔합니다.

토큰은 ~/.xiaomi-mcp/tokens.json]에 저장됩니다.

##2. Claude 코드에 연결

그게 다야! 지금 당신은 당신의 장치에 대화할 수 있습니다:

“램프 켜기” “방 온도는 무엇입니까?” “문이 잠겨 있습니까?” “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: