Back to Home
Blizarre icon

HomeMCP

Verified Safe

by 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

Run Command
uv run python main.py

Environment 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

Stats

Interest Score0
Security Score8
Cost ClassMedium
Avg Tokens1250
Stars0
Forks0
Last Update2025-12-25

Tags

Home AutomationMCP ServerRadio PlayerTelegramAI Integration