mijiaAPI

by Do1e

A Python API for Xiaomi Mijia devices. Requires Python >= 3.10. Supports control via code, CLI, and MCP. Authentication file path is configurable via MCP args.

LifestylestdioCommunity

Repository-wide counts · Cached 2026-08-19

Overview

The mijiaAPI MCP server is a publicly available project. Review the upstream repository for installation instructions, supported tools, compatibility, permissions, and current maintenance status.

Configuration

Configuration, transport, authentication, and runtime requirements vary by project. Open the repository before connecting and use the smallest set of credentials and permissions required.

Open the mijiaAPI repository to read the latest documentation.

KEEP EXPLORING

Compare source, connection, and authentication details before choosing an implementation.

View the complete category

iMCP

mattt

Community

iMCP 是一款 macOS 应用,用于将您的数字生活与 AI 连接,提供日历、联系人、位置、地图、消息、提醒事项和天气服务的访问。它包含一个通过标准输入输出(stdio)通信的命令行可执行文件 'imcp-server'。无需配置任何外部数据文件或环境变量。

Bazi MCP (八字 MCP) by Cantian AI

cantian-ai

Community

The Bazi MCP is the first AI-powered Bazi calculator providing precise Bazi data for personality analysis and destiny forecasting. Requires Node.js version 22 or above.

ActivityWatch MCP 服务器

8bitgentleman

Community

一个 Model Context Protocol (MCP) 服务器,连接到 ActivityWatch,允许像 Claude 这样的大型语言模型(LLMs)与您的时间跟踪数据交互。需要已安装并运行的 ActivityWatch。

通胜 MCP 服务

baranwang

Community

Chinese traditional Tung Shing (黄历/通勝/通胜) almanac calculation service based on Model Context Protocol (MCP). Supports Gregorian-Lunar calendar conversion, daily auspicious and taboo activities, hourly information, and detailed traditional metaphysical elements.

FROM THE SOURCE

Repository README

Build-time snapshot · Retrieved 2026-10-05

View original

mijiaAPI

米家 API,可以使用代码、CLI、MCP 直接控制米家设备。

🎉 v4.0.0 版本已支持 MCP,详见 MCP 使用文档
🎉 v4.1.0 版本已支持 Agent Skill,详见 Agent Skill 使用文档

GitHub PyPI License: GPL-3.0

📖 完整文档请见 mijia-api.do1e.com

常见问题 | 更新日志

安装

要求 Python >= 3.10

pip install mijiaAPI
# uv 用户可使用 `uv add mijiaAPI`

其他安装方式(源码安装、AUR)请参考文档。

快速开始

from mijiaAPI import mijiaAPI, mijiaDevice

# 初始化并扫码登录(认证文件默认保存在 ~/.config/mijia-api/auth.json)
api = mijiaAPI()
api.login()

# 通过设备名称控制设备(推荐)
device = mijiaDevice(api, dev_name="我的台灯")
device.on = True              # 打开设备
device.brightness = 60        # 设置亮度为 60%

# 查看设备支持的所有属性和动作
print(device)

CLI 用法:

mijiaAPI login                          # 扫码登录
mijiaAPI -l                             # 列出所有设备
mijiaAPI set --dev_name "台灯" --prop_name "brightness" --value 60

MCP 用法:

执行 uvx mijiaAPI login -p /path/to/auth.json 登录后,在 MCP 客户端配置中添加以下内容即可接入米家:

{
  "mcpServers": {
    "mijia-api": {
      "command": "uvx",
      "args": ["mijiaAPI[mcp]", "mcp", "-p", "/path/to/auth.json"]
    }
  }
}

更多用法(API 基础调用、MCP Server、CLI 完整参数、最佳实践等)请查阅完整文档。

致谢

开源许可

本项目采用 GPL-3.0 开源许可证。

请注意:GPL-3.0 是具有“强传染性”的开源许可证。
如果您在您的项目中使用、修改或分发本项目的代码(包括作为库依赖),您的整个项目也必须以 GPL-3.0 或兼容许可证开源发布。

免责声明

  • 本项目仅供学习交流使用,不得用于商业用途,如有侵权请联系删除
  • 用户使用本项目所产生的任何后果,需自行承担风险
  • 开发者不对使用本项目产生的任何直接或间接损失负责