Skip to main content
Glama
handsomejustin

Xiaomi smart home MCP server

by handsomejustin
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MIJIA_TOKENYesAccess token obtained from login or API
MIJIA_API_URLYesThe base URL of the mijia-control API server, e.g. http://127.0.0.1:5000/api

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_devicesA

列出所有米家智能设备。返回设备ID、名称、型号、在线状态等信息。

Args:
    home_id: 按家庭ID过滤，不传则返回全部设备
    refresh: 是否强制刷新设备列表缓存
get_deviceA

获取设备详情，包含设备规格、可用属性列表和动作列表。

Args:
    did: 设备ID
get_propertyB

读取设备属性值，例如灯光亮度、空调温度、开关状态等。

Args:
    did: 设备ID
    prop_name: 属性名称，如 power、brightness、temperature
set_propertyA

设置设备属性值，用于控制设备。例如开灯、调亮度、设温度等。

Args:
    did: 设备ID
    prop_name: 属性名称，如 power、brightness、temperature
    value: 属性值，类型取决于属性定义。常见值：power 为 "on"/"off"，brightness 为 0-100，temperature 为数字
run_actionC

执行设备动作，例如扫地机开始清扫、播放音乐等。

Args:
    did: 设备ID
    action_name: 动作名称，如 start-sweep、stop-sweeping
    value: 动作参数，可选
list_scenesA

列出所有米家场景。

Args:
    home_id: 按家庭ID过滤
    refresh: 是否强制刷新缓存
run_sceneC

执行一个米家场景，触发该场景中预设的所有设备操作。

Args:
    scene_id: 场景ID
list_homesB

列出所有家庭及其设备概览。

Args:
    refresh: 是否强制刷新缓存
get_homeB

获取家庭详情，包含该家庭下的所有设备列表。

Args:
    home_id: 家庭ID
list_ble_devicesA

列出所有已注册的蓝牙传感器设备，返回设备信息和最新温湿度读数。

get_ble_sensorB

获取蓝牙传感器的最新温湿度数据和设备详情。

Args:
    did: BLE 设备ID，如 blt.3.xxxxx
get_ble_readingsA

查询蓝牙传感器的历史温湿度读数，用于趋势分析。

Args:
    did: BLE 设备ID
    hours: 查询最近多少小时的数据，默认 24
    limit: 最大返回条数，默认 100

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored across 12 tools

Disambiguation4/5

Tools are largely distinct by resource: devices, scenes, homes, and BLE sensors. However, get_device, get_property, and get_ble_sensor could be confused for retrieving device info, but descriptions clarify their specific focus (details vs. property vs. BLE sensor). Overall, minimal overlap.

Naming Consistency4/5

Naming follows a consistent verb_noun pattern for most tools (list_devices, get_device, set_property, run_scene, etc.). Minor deviations: 'get_ble_readings' uses a different plural form but still fits the pattern. Overall, the pattern is clear and predictable.

Tool Count5/5

With 12 tools, the server covers a reasonable scope for a smart home integration. Each tool serves a distinct function, and the count is within the ideal range, not excessive or insufficient.

Completeness4/5

The surface covers device listing/detail, property read/write, actions, scenes, homes, and BLE sensor data. Missing are device creation/removal (likely not applicable for a smart home) and maybe a bulk operation or scene creation/update. However, the core control workflows are well covered, with minor gaps for advanced management.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources