c4-mcp
Verified Safeby randybritsch
Overview
Exposes Control4 home automation capabilities as Model Context Protocol (MCP) tools for AI agents and other clients to query rooms/devices and safely run automations on a local network.
Installation
python app.pyEnvironment Variables
- C4_CONFIG_PATH
- C4_HOST
- C4_USERNAME
- C4_PASSWORD
- C4_TOKEN_TTL_S
- C4_AUTH_TIMEOUT_S
- C4_DIRECTOR_TIMEOUT_S
- C4_HTTP_TIMEOUT_S
- C4_GET_ALL_ITEMS_TIMEOUT_S
- C4_ITEMS_CACHE_TTL_S
- C4_STDIO_TOOL_MODE
- C4_STDIO_TOOL_ALLOWLIST
- C4_STDIO_TOOL_DENYLIST
- C4_STDIO_DEBUG
- C4_WRITES_ENABLED
- C4_WRITE_GUARDRAILS
- C4_WRITE_ALLOWLIST
- C4_WRITE_DENYLIST
Security Notes
The project is designed with security in mind for local network operation. Credentials (host, username, password) are loaded from a gitignored `config.json` or environment variables, with explicit warnings against committing secrets. It enforces 'safe-by-default' controls, requiring explicit environment variable (`C4_WRITES_ENABLED=true`) to enable state-changing actions, and supports allow/deny lists for tools. Network communication with the Control4 Director on the local LAN uses `aiohttp` with `ssl=False`, which disables certificate verification. This is a common practice for local systems with self-signed certificates but means it won't detect local Man-in-the-Middle attacks. The `discover_controller.py` tool performs local IP scanning, which is a discovery feature. No 'eval' or obvious malicious patterns were found. Overall, it's responsibly built for its intended local-only use case.
Similar Servers
ha-mcp
Provides AI agents with complete control over Home Assistant via REST and WebSocket APIs, offering a comprehensive suite of tools for smart home management, automation, and debugging.
advanced-homeassistant-mcp
A powerful, secure, and extensible Model Context Protocol (MCP) server that enables AI assistants like Claude, GPT, and Cursor to seamlessly interact with Home Assistant. Control your lights, climate, automations, and more through natural language commands.
openhab-mcp
This project provides an MCP (Model Context Protocol) server to enable AI assistants like Claude and Cline to interact with and manage a real openHAB smart home system via its REST API.
atlantis-mcp-server
An MCP (Model Context Protocol) server for hosting and managing dynamic Python functions and third-party MCP tools, enabling AI agents to discover and utilize shared capabilities across a network.