一一用 TypeScript + Python 的 Model Context Protocol (MCP) , mi的 mi家 mi,、设备列表、属性读、属性读、场景联动、耗材查询、统计数据等常见操作、 mi、 mi。

₢ 킹

인포메이션 인포메이션 | [T0] | 家下下的下家 | | get_mijia_devices | 家, | | [T2] | T,/元元元 | | 【T3】 | 行行(T、切换场景、切换场景) | | list_mijia_scenes | 후쿠오카현 | [T5] | 定场景(星)、「鶏安」 | | [T6] | /ᴗ件)(T、)) | | [T7] | 炉端串取小(小口/天/주/月) | | [T8] | (T) 인포메이션 센터

T[T10]],T有真实账号时调试。

安

🔐( )

1.** 1.: ANSI 字()展))。 2.(一一一):

A, A一一的一。 4.。 5. 인가기관 증명 ~/.config/mijia-api/auth.json](도보로 [T12]]])。 6. 之后调用 MCP BASE会 用 토큰, 토큰 。

****:提示目下下信息,T .env] 中中 MIJIA_AUTH_PATH=./.mijia-api/auth.json]。

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

c:/Users/chenz/AppData/Local/CodeBuddyExtension/Cache/CodeBuddyIDE/CodeBuddy/mcp/settings.json c:/Users/chenz/AppData/Local/CodeBuddyExtension/Cache/CodeBuddyIDE/CodeBuddy/mcp/settings.json]] [T15]] [T15]] [T15]] [T15]] [T15]] [T15]] [T15]] [T15]] [T15] [T15]] [T15]] [T15]] [T15] [T15]] [T15]] [T15]] [T15] [T15]] [T15] [T15]] [T15]] [T15]] [T15] [T15]] c:/Users/chenz/AppData/Local/CodeBuddyExtension/Cache/CodeBuddyIDE/CodeBuddy/mcp/settings.json] c:/Users/chenz/AppData/Local/CodeBuddyExtension/Cache/CodeBuddyIDE/CodeBuddy/mcp/settings.json] [c:/Users/chenz/AppData/Local/CodeBuddyExtension/Cache/CodeBuddyIDE/CodeBuddy/mcp/settings.json]]]]]] [[[[[[c:/Users/chenz/AppData/Local/CodeBuddyExtension/Cache/CodeBuddyIDE/CodeBuddy/mcp/settings.json]]]]]]]]]]]] [[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]][[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]

get_mijia_devices

My MCP Server · 米家智能控制

一个使用 TypeScript + Python 构建的 Model Context Protocol (MCP) 服务器，整合了 mijiaAPI 提供的米家智能家居能力，支持扫码登录、设备列表、属性读取与设置、场景联动、耗材查询、统计数据等常见操作。

✨ 功能概览

每个工具都支持 use_mock=true，便于在没有真实账号时调试。

🧱 项目结构

my-mcp-server/
├── src/index.ts                  # MCP 主入口（TypeScript）
├── dist/index.js                 # 构建输出
├── python_scripts/
│   ├── mijia_helper.py           # 登录、缓存、API 封装
│   ├── mijia_tool.py             # action 路由脚本
│   ├── get_mijia_devices.py      # 兼容旧入口（委托给 mijia_tool ）
│   ├── get_device_status.py
│   ├── control_device.py
│   ├── requirements.txt          # Python 依赖
│   └── test_environment.py       # 环境检测脚本
├── README.md / SETUP_GUIDE.md    # 文档
└── ...

🚀 安装与构建

# 安装 Node 依赖
npm install

# 安装 Python 依赖（建议在虚拟环境中执行）
pip install -r python_scripts/requirements.txt

# 构建 TypeScript
npm run build

🔐 首次扫码登录（必做）

1. 准备终端：确保终端可以正常显示 ANSI 字符（以便展示二维码）。

2. 执行登录命令（选择任意一种）：

   # 方式一：使用 Python 模块
   python -m mijiaAPI -l
   
   # 方式二：使用 CLI 命令
   mijiaAPI -l
   

3. 终端会打印 ASCII 二维码，同时输出一个可访问的二维码链接。

4. 用米家 APP 扫描二维码并确认登录。

5. 认证信息会自动保存到 ~/.config/mijia-api/auth.json（可通过 MIJIA_AUTH_PATH 修改）。

6. 之后调用 MCP 工具会自动复用 Token，除非 Token 过期。

提示：若希望在项目目录下保存认证信息，可在 .env 中设置 MIJIA_AUTH_PATH=./.mijia-api/auth.json。

⚙️ MCP 配置示例

c:/Users/chenz/AppData/Local/CodeBuddyExtension/Cache/CodeBuddyIDE/CodeBuddy/mcp/settings.json

{
  "mcpServers": {
    "mijia-mcp-server": {
      "command": "node",
      "args": ["c:/Users/chenz/CodeBuddy/20251216173558/dist/index.js"],
      "type": "stdio",
      "env": {
        "PYTHON_PATH": "c:/Users/chenz/CodeBuddy/20251216173558/.venv/Scripts/python.exe",
        "PYTHON_SCRIPT_DIR": "c:/Users/chenz/CodeBuddy/20251216173558/python_scripts",
        "MIJIA_AUTH_PATH": "c:/Users/chenz/.config/mijia-api/auth.json"
      }
    }
  }
}

🛠️ 工具参数参考

get_mijia_devices

• home_id (string, 可选)：指定家庭 ID
• include_shared (boolean, default false)
• use_mock (boolean, 可选)

get_device_status

• device_id 或 device_name（至少一个）
• properties (string[])：需要读取的属性列表（如 on, brightness）
• include_metadata (boolean, default true)
• sleep_time (number)：读取间隔（秒）

control_device

• device_id 或 device_name
• operation：set_property / run_action
• prop_name + value：用于 set_property
• action_name + action_value：用于 run_action
• action_kwargs / params：为动作提供额外参数

list_mijia_scenes