HomeMCP
Verified Safeby Blizarre
Overview
A personal home automation server that plays radio and sends Telegram messages, designed to be controlled by an AI assistant like Claude.
Installation
uv run python main.pyEnvironment Variables
- TELEGRAM_BOT_TOKEN
- MY_CHAT_ID
- MADAME_CHAT_ID
- PLAYER_ARGS
- PORT
- HOST
Security Notes
The server uses `subprocess.Popen` for playing audio, but the arguments (`config.player_args` and `radio.url`) are derived from local configuration files (`.env` and `radios.json`) and not directly from untrusted user input, mitigating command injection risks. Telegram API calls are made with a bot token and chat IDs loaded from `.env`, which is good practice. The `send.sh` script relies on `claude`'s tool calling safety to prevent misuse. There are no hardcoded secrets or obvious `eval` patterns. The primary security consideration is ensuring the `.env` file is secured and `player_args` is configured safely, as well as the inherent risks associated with piping arbitrary transcription output to an LLM for tool execution, although `--allowedTools=home` limits the scope.
Similar Servers
memcord
A privacy-first, self-hosted MCP server for organizing chat history, summarizing messages, and searching past conversations using AI, particularly for Claude interactions.
stt-mcp-server-linux
Local speech-to-text server for Linux, designed to integrate with Claude Code via the MCP protocol or run in standalone mode to inject transcribed text into a Tmux session.
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.
mcp-arr
Manages media content across *arr applications (Sonarr, Radarr, Lidarr, Readarr, Prowlarr) and integrates with TRaSH Guides for configuration best practices.