home / mcp / jenius mcp server

Jenius MCP Server

基于 Home Assistant ，快速实现 MCP 服务器对智能家居设备的远程控制

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "jenius-group-jenius-mcp-smart-device": {
      "command": "uv",
      "args": [
        "run",
        "jenius_mcp.py"
      ],
      "env": {
        "JENIUS_SMART_DEVICE_MCP_HOST": "127.0.0.1",
        "JENIUS_SMART_DEVICE_MCP_SSE_PATH": "/sse",
        "JENIUS_SMART_DEVICE_MCP_SSE_PORT": "YOUR_SSE_PORT",
        "JENIUS_SMART_DEVICE_MCP_TRANSPORT": "stdio",
        "JENIUS_SMART_DEVICE_MCP_MESSAGE_PATH": "/messages/"
      }
    }
  }
}

You can run a Python-based MCP server that bridges Jenius smart-device capabilities with your home environment. It exposes a local server you can start with a lightweight tool, connects to your Home Assistant setup, and lets you control supported smart devices through MCP-powered actions and prompts.

How to use

You will connect an MCP client to the server to start issuing control and automation tasks. Begin by ensuring the server is running and reachable at the configured host and port. Use the client to send requests that trigger device actions, such as turning on an air purifier, adjusting a speaker, or commanding a vacuum robot. The server supports a STDIO-based local runtime so you can run it directly from your development or runtime environment, and it can also be driven from a Home Assistant bridge for centralized control.

Typical usage flow: - Start the MCP server in STDIO mode from your project directory. - Point your MCP client to the running server using the local host URL and port, or use a SSE-based route if you enable streaming updates. - Configure environment values to connect to your Home Assistant instance and to specify how Jenius should expose capabilities to your devices. - Send control prompts or scripted tasks from your client to perform actions across your supported devices. The server translates those prompts into concrete device operations through the MCP runtime.

How to install

Prerequisites you need before installing: - Python runtime (preferred for the Jenius MCP server). - UV tool for environment management and dependency handling.

Step-by-step setup in the project root: - Ensure you have Python and UV installed on your system. - Install or synchronize dependencies using UV. - Start the MCP server in STDIO mode. You can run it with the command below.

uv sync
uv run jenius_mcp.py

# Optional example with explicit network and transport settings
uv run jenius_mcp.py --host 0.0.0.0 --port 8981 --transport sse

Additional configuration and notes

Environment configuration for the MCP server includes options to set where the server runs, how it transports messages, and how it connects to your Home Assistant control center. You will define runtime values such as host, transport protocol, SSE port, and paths for messages.

Key environment variables shown in the config: - JENIUS_SMART_DEVICE_MCP_HOST: Host where the MCP server will listen - JENIUS_SMART_DEVICE_MCP_TRANSPORT: Transport protocol (e.g., stdio or sse) - JENIUS_SMART_DEVICE_MCP_SSE_PORT: Port for SSE streaming - JENIUS_SMART_DEVICE_MCP_SSE_PATH: Path for SSE endpoint - JENIUS_SMART_DEVICE_MCP_MESSAGE_PATH: Path for message routing

Home Assistant integration requires setting the control center URL and the authorization header. For example, you configure your base URL and supply your API key so the MCP server can communicate with your Home Assistant instance securely.

Supported endpoints and actions include control commands for smart devices such as air purifiers, smart speakers, robotic vacuum cleaners, and smart cameras. You can adapt device entity identifiers in your environment configuration to match your actual devices and ensure the MCP prompts call the correct actions.