Jenius MCP Smart Device

🚀 Jenius: A Supported Smart Home Control Tool

Jenius is a general multi-agent AI Agent independently developed by Tianju Dihe (Suzhou) Technology Co., Ltd. By deeply integrating the multi-agent collaboration architecture with real-time data service capabilities, it is committed to achieving a full-link closed-loop from "requirement understanding" to "precise execution". Jenius has独创 a "data + agent + RPA" triangular engine. Relying on the massive resources of the aggregated data platform under Tianju Dihe and self-developed RPA technology, it focuses on solving the in-depth service requirements of complex scenarios, especially showing amazing execution capabilities in vertical fields such as travel itinerary planning, marketing campaign generation, and report analysis.

📦 Project Structure

.
├── README.md                # Project description document
├── Home Assistant Guide.md  # Home Assistant setup guide
├── jenius_mcp.py            # Main entry of MCP service
├── tools/                   # MCP toolset
│   ├── __init__.py          # Initialization file of MCP toolset
│   ├── common.py            # General utility functions
│   └── mcp/                 # Specific implementation of MCP
├── utils/                   # Utility functions
├── img/                     # Project images
├── .mcp.env                 # MCP environment configuration
├── Dockerfile               # Docker build file
├── mcp_server.tpl           # MCP server template
├── pyproject.toml           # Python project configuration
├── requirements.txt         # Python dependency file
└── uv.lock                  # UV dependency lock file

💻 Usage Process

🛠️ Set Up the Home Assistant Control Center

We recommend using Home Assistant as a bridge to connect the MCP server and smart home terminals. By connecting smart home devices to Home Assistant and configuring the URL and key of the smart home control center, you can quickly enable the MCP server to remotely control smart home devices. For specific operations, please refer to the following document:

Home Assistant Setup Guide

⚙️ Configure the Environment

MCP Server Environment Configuration

# SERVER HOST (Supports Arg parameter passing)
JENIUS_SMART_DEVICE_MCP_HOST = 127.0.0.1

# Jenius MCP TRANSPORT protocol configuration (Supports Arg parameter passing)
JENIUS_SMART_DEVICE_MCP_TRANSPORT = stdio

# If using the SSE method, configure the following
JENIUS_SMART_DEVICE_MCP_SSE_PORT = YOUR_SSE_PORT
JENIUS_SMART_DEVICE_MCP_SSE_PATH = "/sse"
JENIUS_SMART_DEVICE_MCP_MESSAGE_PATH = "/messages/"

Home Assistant Control Center Environment Configuration

# Smart home control center URL configuration
CONTROL_CENTER_BASE_URL = YOUR_HOME_ASSISTANT_BASE_URL

# Smart home control center request header configuration, need to fill in the corresponding key of the account
CONTROL_CENTER__HEADERS = {"Authorization": YOUR_HOME_ASSISTANT_API_KEY, "Content-Type": "application/json"}

Smart Terminal Environment Configuration

# Xiaomi air purifier control
XIAOMI_AIR_PURIFIER_SWITCH_ENTITY_ID = "switch.zhimi_cn_495307311_rma1_on_p_2_1"
XIAOMI_AIR_PURIFIER_MODE_SELECT_ENTITY_ID = "select.zhimi_cn_495307311_rma1_mode_p_2_4"

# Xiaomi smart speaker control
XIAOMI_SPEAKER_SLEEPMODE_SWITCH_ENTITY_ID = "switch.xiaomi_cn_58102534_s12_sleep_mode_p_5_3"
XIAOMI_SPEAKER_MUTE_SWITCH_ENTITY_ID = "switch.xiaomi_cn_58102534_s12_mute_p_2_2"

# Roborock T7 vacuum cleaner control
...

# Xiaomi smart camera control
...

The URL YOUR_HOME_ASSISTANT_BASE_URL and key YOUR_HOME_ASSISTANT_API_KEY of the control center can be obtained by referring to the third and fourth parts of the Home Assistant Setup Guide.

📥 Install UV

uv is a Python environment management tool and the officially recommended Python project management tool for MCP. The installation method is as follows:

https://docs.astral.sh/uv/getting-started/installation/

🚀 Start the MCP Server

If the dependency packages are not installed, you can enter the project root directory and execute the command for synchronization:

uv sync

Start with the STDIO protocol (default):

uv run jenius_mcp.py

You can freely configure the startup parameters, for example:

uv run jenius_mcp.py --host 0.0.0.0 --port 8981 --transport sse

🖥️ Client Configuration

You can use clients such as Cline and Claude Desktop to conveniently configure the MCP server. The configuration examples are as follows:

# STDIO mode
"juhe-mcp-smart_device": { 
    "command": "uv",
    "args": [
        "run",
        "jenius_mcp.py"
    ]
}

# SSE mode
"smart_home_server": {
    "url": "http://0.0.0.0:8981/sse",
    "transport": "sse"
}

📱 Supported Terminals

• Mi Air Purifier 4 Lite
• Xiaomi AI Speaker
• Mi Roborock T7 Vacuum Cleaner
• Xiaomi Smart Camera

All Mi smart devices can be quickly connected by simply replacing your device entity identifier in the environment configuration file. To obtain the device entity identifier, please refer to the fourth part of the Home Assistant Setup Guide.

• Smart Socket SmartHW MF287

The configuration of the smart socket can refer to the user manual of your device. The smart socket has its independent IP address and port. You can connect it by adding information such as your device IP and port in the environment configuration file. At the same time, modify the prompt content and function naming rules of the MCP server according to the type of furniture connected to your socket, so that the large model can better understand and call.

📄 License

This project is licensed under the Apache License 2.0.