Aller au contenu
Se connecter

HA MCP

Conteneur LXC oraad — proxmox-scripts

Accès par défaut

Adresse
http://ADRESSE-IP:8086Remplacez ADRESSE-IP par l'adresse donnée à la fin de l'installation.
Compte et mot de passe
Aucun identifiant fixe publié par la source : ils se créent à l'installation ou à la première connexion.
Console et SSH
Console du conteneur dans l'interface Proxmox : compte root, connexion automatique sans mot de passe. Le SSH de root n'est ouvert que si vous l'avez demandé à l'installation.
Configuration
/opt/ha-mcp

Deploys the official Home Assistant MCP Server (ha-mcp) in HTTP mode via uvx. Provides a LAN MCP endpoint for HTTP-capable MCP clients to control Home Assistant through natural language.

Site ↗ Documentation ↗ Voir le code du script ↗

Installer

Cœurs
1
Mémoire
1 Go
Disque
4 Go
Système
Debian 13
bash -c "$(curl -fsSL https://raw.githubusercontent.com/oraad/proxmox-scripts/main/ct/ha-mcp.sh)"

Configuration : /opt/ha-mcp

Dans le shell du nœud Proxmox. Exécutez cette commande dans le shell du nœud Proxmox, pas dans une VM. Lisez le script d'abord.

Tutoriel pas à pas

De l'interface de Proxmox jusqu'à la première connexion, pour HA MCP.

  1. Ouvrez l'interface de Proxmox dans votre navigateur et connectez-vous.

  2. Dans l'arbre de gauche, cliquez sur votre nœud, puis sur « Shell ».

  3. Vérifiez que le nœud a la place pour ce conteneur : 1 cœur, 1 Go de mémoire, 4 Go de disque.

  4. Copiez cette commande, collez-la dans le shell et appuyez sur Entrée.

    bash -c "$(curl -fsSL https://raw.githubusercontent.com/oraad/proxmox-scripts/main/ct/ha-mcp.sh)"

  5. Attendez la fin de l'installation : le script affiche l'adresse du conteneur.

  6. Ouvrez http://ADRESSE-IP:8086 dans votre navigateur, en remplaçant ADRESSE-IP par l'adresse affichée.

  7. Pour mettre à jour plus tard : tapez update dans la console du conteneur.

  8. Le fichier de configuration se trouve ici : /opt/ha-mcp

À savoir

  • During install a wizard asks for the Home Assistant URL (e.g. http://192.168.1.10:8123) and a long-lived access token (HA Profile → Security → Create Token). The script verifies HA connectivity from inside the container before starting the service. Unattended: var_ha_url=http://192.168.1.10:8123 var_ha_token=YOUR_TOKEN bash -c "$(curl -fsSL https://raw.githubusercontent.com/oraad/proxmox-scripts/main/ct/ha-mcp.sh)".
  • HTTP mode on port 8086 with an auto-generated MCP_SECRET_PATH. Do not expose this port to the internet without a reverse proxy.
  • Home Assistant OS users may prefer the official MCP Server add-on. This script is for Container/Core or standalone LXC deployments.
  • Add the MCP URL printed at install to your MCP client's config — e.g. {"mcpServers":{"home-assistant":{"url":"http://<container-ip>:8086/mcp-<secret>"}}}. That path is MCP_SECRET_PATH itself. A browser GET may return 405; that is expected. Settings UI: http://<container-ip>:8086/mcp-<secret>/settings. See https://github.com/homeassistant-ai/ha-mcp for details. To federate several ha-mcp LXCs behind one MCP URL, install the agentgateway script.
  • Update an existing container: run update inside the LXC, or pct exec <CTID> -- update from the Proxmox host.
  • Retrieve the MCP endpoint anytime: pct exec <CTID> -- cat /opt/ha-mcp/mcp_endpoint.txt
  • HA and this LXC should be on the same LAN/VLAN. Test connectivity from inside the container: curl -sf -H "Authorization: Bearer YOUR_TOKEN" http://YOUR_HA_IP:8123/api/. Use http:// unless HTTPS is configured. Regenerate the token if revoked.
  • Service status — Debian: systemctl status ha-mcp and journalctl -u ha-mcp -n 50. Alpine: rc-service ha-mcp status and tail -50 /var/log/ha-mcp.log.
  • Alpine template: run pveam update, then pveam available --section system | grep alpine-3.24. Download if missing: pveam download local alpine-3.24-default_20260116_amd64.tar.xz (use the exact name from pveam available on your arch). Fallback: var_version=3.22 if 3.24 is not listed on an older Proxmox host.
  • Debian 13 and Alpine installs enable nesting and keyctl by default (Debian: systemd compatibility; Alpine: Docker and tunnel agents).
Dans la même catégorie

Agent Gateway

Conteneur LXC oraad — proxmox-scripts

Deploys the official agentgateway binary as an MCP federation proxy. One public HTTP listener on port 8080 serves the UI (HTTP basic auth) and a Streamable HTTP MCP endp…

Mise à jour Port 8080 Accès par défaut

ESPConnect

Conteneur LXC

ESPConnect is a zero-installation web application that lets you explore, back up, and manage ESP32 devices from a browser.

Mise à jour Port 443

ESPHome

Conteneur LXC

ESPHome is a platform for controlling ESP8266/ESP32-based devices using configuration files and integrating them with Home Automation systems. It provides a simple and f…

Mise à jour Port 6052

FHEM

Conteneur LXC

FHEM stands for "Freundliche Hausautomation und Energie-Messung," which translates to "Friendly Home Automation and Energy Measurement" in English. The software can inte…

Mise à jour Port 8083

Home Assistant Container

Conteneur LXC

A standalone container-based installation of Home Assistant Core means that the software is installed inside a Docker container, separate from the host operating system.…

Mise à jour Port 8123

Home Assistant OS

Machine virtuelle

Home Assistant OS is the appliance image of Home Assistant, managing its own supervisor and add-ons. This installs the official image as a VM.

Port 80