Add comprehensive Claude Code Addon for Home Assistant

FEATURES:
- 🤖 Modern web interface for Claude chat directly in HA
- 🔗 Automatic MCP server integration for file access
- 📱 Responsive design with glassmorphism UI
- ⚡ Real-time WebSocket communication
- 🛡️ Enterprise security (rate limiting, validation, helmet)
- 🎨 Quick action buttons for common HA tasks

TECHNICAL:
- Express.js + Socket.io server
- Anthropic SDK integration
- Home Assistant Ingress support
- Container-optimized with health checks
- Comprehensive error handling and logging
- Token usage tracking and optimization

STRUCTURE:
- config.yaml - HA addon configuration
- Dockerfile - Multi-stage container build
- src/server.js - Main Node.js application
- src/public/index.html - Modern chat interface
- run.sh - Startup script with validation
- README.md - Complete documentation

USAGE:
1. Install addon in HA
2. Configure Anthropic API key
3. Access via Ingress: HA → Add-ons → Claude Code CLI
4. Chat with Claude about HA configuration

The addon automatically connects to the existing MCP server
for direct Home Assistant file system access.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: dawid

claude-code-addon/Dockerfile

@@ -0,0 +1,73 @@
+ARG BUILD_FROM
+FROM $BUILD_FROM
+
+# Install Node.js, npm and dependencies
+RUN apk add --no-cache \
+        nodejs \
+        npm \
+        bash \
+        python3 \
+        py3-yaml \
+        curl \
+        git \
+    && rm -rf /var/cache/apk/*
+
+# Create app user
+RUN addgroup -g 1000 appuser && \
+    adduser -D -s /bin/bash -u 1000 -G appuser appuser
+
+# Create app directory
+WORKDIR /app
+
+# Copy package.json and install dependencies
+COPY src/package.json /app/package.json
+RUN npm install --production && \
+    chown -R appuser:appuser /app
+
+# Copy application files
+COPY src/ /app/
+COPY run.sh /run.sh
+
+# Set permissions
+RUN chmod +x /run.sh && \
+    chown -R appuser:appuser /app
+
+# Labels
+ARG BUILD_ARCH
+ARG BUILD_DATE
+ARG BUILD_DESCRIPTION
+ARG BUILD_NAME
+ARG BUILD_REF
+ARG BUILD_REPOSITORY
+ARG BUILD_VERSION
+
+LABEL \
+    io.hass.name="${BUILD_NAME}" \
+    io.hass.description="${BUILD_DESCRIPTION}" \
+    io.hass.arch="${BUILD_ARCH}" \
+    io.hass.type="addon" \
+    io.hass.version="${BUILD_VERSION}" \
+    maintainer="DawidSu" \
+    org.opencontainers.image.title="${BUILD_NAME}" \
+    org.opencontainers.image.description="${BUILD_DESCRIPTION}" \
+    org.opencontainers.image.vendor="Home Assistant Community Add-ons" \
+    org.opencontainers.image.authors="DawidSu" \
+    org.opencontainers.image.licenses="MIT" \
+    org.opencontainers.image.url="https://github.com/DawidSu/ha-mcp-server" \
+    org.opencontainers.image.source="https://github.com/DawidSu/ha-mcp-server" \
+    org.opencontainers.image.documentation="https://github.com/DawidSu/ha-mcp-server/blob/main/README.md" \
+    org.opencontainers.image.created="${BUILD_DATE}" \
+    org.opencontainers.image.revision="${BUILD_REF}" \
+    org.opencontainers.image.version="${BUILD_VERSION}"
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+  CMD curl -f http://localhost:8080/health || exit 1
+
+# Switch to app user
+USER appuser
+
+# Expose port
+EXPOSE 8080
+
+CMD [ "/run.sh" ]

claude-code-addon/README.md

@@ -0,0 +1,165 @@
+# Claude Code Addon für Home Assistant
+
+Ein vollwertiges **Claude Code Web-Interface** direkt in Home Assistant! Chatte mit Claude über eine moderne Web-Oberfläche und nutze dabei die volle Power des MCP (Model Context Protocol) Servers für direkten Zugriff auf deine Home Assistant Konfiguration.
+
+## 🌟 Features
+
+- **🤖 Claude Chat Interface** - Moderne Web-Oberfläche für Claude Conversations
+- **🔗 MCP Integration** - Automatische Verbindung zum MCP Server für Dateizugriff  
+- **🏠 Home Assistant Integration** - Läuft als Addon mit Ingress-Unterstützung
+- **📱 Responsive Design** - Funktioniert auf Desktop, Tablet und Smartphone
+- **⚡ Echtzeit-Features** - WebSocket-Verbindung für Live-Status
+- **🛡️ Sicherheit** - Rate Limiting, Input Validation, Helmet Security Headers
+- **🎨 Moderne UI** - Gradient-Design mit Glassmorphism-Effekten
+
+## 📋 Installation
+
+### 1. Voraussetzungen
+- **Claude MCP Server Addon** muss installiert und aktiv sein
+- **Anthropic API Key** (kostenlos bei anthropic.com)
+
+### 2. Addon Installation
+1. Füge das Repository zu Home Assistant hinzu
+2. Installiere das "Claude Code CLI" Addon
+3. Konfiguriere den Anthropic API Key
+4. Starte das Addon
+
+### 3. Konfiguration
+
+```yaml
+anthropic_api_key: "sk-ant-api03-..."  # Dein API Key von anthropic.com
+model: "claude-3-5-sonnet-20241022"    # Claude Modell
+max_tokens: 4096                       # Maximale Token pro Response  
+auto_connect_mcp: true                 # Automatische MCP Verbindung
+mcp_server_host: "localhost"           # MCP Server Host
+mcp_server_port: 3000                  # MCP Server Port
+log_level: "info"                      # Log Level
+```
+
+## 🚀 Nutzung
+
+### Web-Interface
+1. Öffne das Addon über **Home Assistant → Einstellungen → Add-ons → Claude Code CLI**
+2. Klicke auf "OPEN WEB UI" oder nutze das Ingress-Interface
+3. Beginne zu chatten!
+
+### Beispiel-Prompts
+```
+"Zeige mir meine Home Assistant Konfiguration"
+"Erstelle eine Automation für den Flur-Bewegungsmelder"  
+"Analysiere meine Automationen auf Fehler"
+"Schreibe ein Script für den Gute-Nacht-Modus"
+"Optimiere meine configuration.yaml"
+```
+
+### Quick Actions
+Das Interface bietet vorgefertigte Buttons für häufige Aufgaben:
+- 📁 **Konfiguration anzeigen** 
+- ⚡ **Automation erstellen**
+- 🔍 **Fehlercheck**
+- 🌙 **Script erstellen**
+
+## 🔧 Erweiterte Konfiguration
+
+### API Key erhalten
+1. Gehe zu [anthropic.com](https://console.anthropic.com)
+2. Erstelle einen Account 
+3. Generiere einen API Key
+4. Key beginnt mit `sk-ant-api03-...`
+
+### MCP Server Verbindung
+Das Addon verbindet sich automatisch mit dem Claude MCP Server:
+- **Host**: `localhost` (Standard)
+- **Port**: `3000` (Standard)
+- **Auto-Connect**: `true` (Standard)
+
+### Modell-Auswahl
+Verfügbare Claude Modelle:
+- `claude-3-5-sonnet-20241022` (Empfohlen - Balance aus Speed und Qualität)
+- `claude-3-5-haiku-20241022` (Schnell und günstig)
+- `claude-3-opus-20240229` (Höchste Qualität, langsamer)
+
+## 🛡️ Sicherheit
+
+- **Rate Limiting**: 10 Requests pro Minute pro IP
+- **Input Validation**: Nachrichtenlänge und Format werden validiert
+- **Helmet Security**: HTTP Security Headers aktiviert  
+- **API Key Schutz**: Keys werden nicht in Logs angezeigt
+- **CORS Schutz**: Nur erlaubte Origins können zugreifen
+
+## 🔍 Troubleshooting
+
+### Claude nicht verfügbar
+```
+Problem: "Claude ist nicht verfügbar"
+Lösung: API Key in Addon-Einstellungen prüfen
+```
+
+### MCP Verbindung fehlgeschlagen  
+```
+Problem: "MCP server not reachable"
+Lösung: Claude MCP Server Addon starten
+```
+
+### Performance-Probleme
+```
+Problem: Langsame Responses
+Lösung: 
+- Zu claude-3-5-haiku wechseln
+- max_tokens reduzieren
+- Conversation History kürzen
+```
+
+### Container startet nicht
+```
+bash
+# Logs prüfen:
+docker logs addon_local_claude-code-cli
+
+# Häufige Ursachen:
+- Ungültiger API Key Format
+- Port 8080 bereits belegt
+- Node.js Dependencies fehlen
+```
+
+## 📊 Status & Monitoring
+
+Das Interface zeigt Live-Status an:
+- **🟢 Claude**: Anthropic API verfügbar
+- **🟢 MCP Server**: Verbindung zum MCP Server
+- **Model Info**: Aktuell verwendetes Claude Modell
+
+## 🔄 Updates
+
+Das Addon updated sich automatisch über Home Assistant:
+1. Neue Version wird in Add-ons angezeigt
+2. "Update" Button klicken
+3. Restart erfolgt automatisch
+
+## 💡 Tipps & Tricks
+
+### Effiziente Prompts
+- **Spezifisch sein**: "Erstelle Automation für Küche" statt "Hilfe"
+- **Kontext geben**: "Analysiere automation.yaml auf Syntaxfehler" 
+- **Schrittweise**: Große Aufgaben in kleine Teile aufteilen
+
+### Token sparen
+- **Kurze Messages**: Lange Conversations verbrauchen mehr Token
+- **Clear Context**: "Vergiss vorherige Conversation" für neue Themen
+- **Haiku Model**: Für einfache Fragen claude-3-5-haiku nutzen
+
+### Bessere Results
+- **Beispiele geben**: "Erstelle Automation wie diese: [YAML]"
+- **Format spezifizieren**: "Als YAML Code ausgeben"
+- **Validation**: "Prüfe den Code auf Syntax-Fehler"
+
+## 🆘 Support
+
+Bei Problemen:
+1. **Logs checken**: Home Assistant → Add-ons → Claude Code CLI → Logs
+2. **Issue erstellen**: [GitHub Issues](https://github.com/DawidSu/ha-mcp-server/issues)
+3. **Community**: Home Assistant Community Forum
+
+---
+
+**Viel Spaß mit Claude Code in Home Assistant! 🎉**

claude-code-addon/config.yaml

@@ -0,0 +1,43 @@
+name: Claude Code CLI
+version: "1.0.0"
+slug: claude-code-cli
+description: Claude Code CLI direkt in Home Assistant - Chat mit Claude über Web-Interface
+url: https://github.com/DawidSu/ha-mcp-server
+arch:
+  - armhf
+  - armv7
+  - aarch64
+  - amd64
+  - i386
+startup: services
+boot: manual
+init: false
+hassio_api: true
+hassio_role: manager
+ingress: true
+ingress_port: 8080
+panel_icon: mdi:robot
+panel_title: Claude Code
+ports:
+  8080/tcp: 8080
+ports_description:
+  8080/tcp: Claude Code Web Interface
+map:
+  - config:rw
+  - addons_local:rw
+options:
+  anthropic_api_key: ""
+  model: "claude-3-5-sonnet-20241022"
+  max_tokens: 4096
+  auto_connect_mcp: true
+  mcp_server_host: "localhost"
+  mcp_server_port: 3000
+  log_level: "info"
+schema:
+  anthropic_api_key: password
+  model: list(claude-3-5-sonnet-20241022|claude-3-5-haiku-20241022|claude-3-opus-20240229)?
+  max_tokens: int(1000,8000)?
+  auto_connect_mcp: bool?
+  mcp_server_host: str?
+  mcp_server_port: port?
+  log_level: list(debug|info|warning|error)?

claude-code-addon/run.sh

@@ -0,0 +1,87 @@
+#!/usr/bin/with-contenv bashio
+set -euo pipefail
+
+# Get configuration from addon options
+API_KEY=$(bashio::config 'anthropic_api_key')
+MODEL=$(bashio::config 'model')
+MAX_TOKENS=$(bashio::config 'max_tokens')
+AUTO_CONNECT_MCP=$(bashio::config 'auto_connect_mcp')
+MCP_HOST=$(bashio::config 'mcp_server_host')
+MCP_PORT=$(bashio::config 'mcp_server_port')
+LOG_LEVEL=$(bashio::config 'log_level')
+
+# Validate configuration
+if [ -z "$API_KEY" ]; then
+    bashio::log.warning "Kein Anthropic API Key konfiguriert!"
+    bashio::log.warning "Bitte API Key in den Addon-Einstellungen hinzufügen."
+    bashio::log.warning "Claude Funktionalität ist deaktiviert bis API Key gesetzt ist."
+fi
+
+# Export environment variables for Node.js app
+export ANTHROPIC_API_KEY="$API_KEY"
+export ADDON_OPTIONS=$(bashio::addon.options)
+export NODE_ENV=production
+export PORT=8080
+
+# Log configuration (without exposing API key)
+bashio::log.info "Starting Claude Code Addon..."
+bashio::log.info "Model: $MODEL"
+bashio::log.info "Max Tokens: $MAX_TOKENS"
+bashio::log.info "MCP Auto Connect: $AUTO_CONNECT_MCP"
+bashio::log.info "MCP Server: $MCP_HOST:$MCP_PORT"
+bashio::log.info "Log Level: $LOG_LEVEL"
+
+# Validate API key format (without logging it)
+if [ -n "$API_KEY" ]; then
+    if echo "$API_KEY" | grep -q "^sk-ant-"; then
+        bashio::log.info "✅ API Key format appears valid"
+    else
+        bashio::log.warning "⚠️ API Key format may be invalid (should start with 'sk-ant-')"
+    fi
+fi
+
+# Check if MCP server is reachable if auto-connect is enabled
+if [ "$AUTO_CONNECT_MCP" = "true" ]; then
+    bashio::log.info "Testing MCP server connection..."
+    if timeout 5 bash -c "</dev/tcp/$MCP_HOST/$MCP_PORT" 2>/dev/null; then
+        bashio::log.info "✅ MCP server is reachable at $MCP_HOST:$MCP_PORT"
+    else
+        bashio::log.warning "⚠️ MCP server not reachable at $MCP_HOST:$MCP_PORT"
+        bashio::log.warning "Make sure the Claude MCP Server addon is running"
+    fi
+fi
+
+# Change to app directory
+cd /app
+
+# Check if dependencies are installed
+if [ ! -d "node_modules" ]; then
+    bashio::log.error "Node.js dependencies not found!"
+    bashio::log.error "Container may not have built correctly"
+    exit 1
+fi
+
+# Verify Node.js
+if ! node --version >/dev/null 2>&1; then
+    bashio::log.error "Node.js not available!"
+    exit 1
+fi
+
+bashio::log.info "Node.js version: $(node --version)"
+
+# Set up signal handling for graceful shutdown
+cleanup() {
+    bashio::log.info "Shutting down Claude Code Addon..."
+    # Kill any background processes
+    pkill -f "node.*server.js" 2>/dev/null || true
+    exit 0
+}
+
+trap cleanup SIGTERM SIGINT
+
+# Start the application
+bashio::log.info "Starting Claude Code web interface on port 8080..."
+bashio::log.info "Access via Home Assistant Ingress"
+
+# Run the Node.js server
+exec node server.js