Proyecto

Versión

Tiempo de ejecución

Superficie orientada al usuario

Integración HA

v16.0.1

Home Assistant

Entidades de interfaz, tarjeta Lovelace, automatizaciones

CLI de Python

v10.12.3

terminal

Comandos bosch_camera ...

Adaptador de ioBroker

v1.8.3

ioBroker

Puntos de datos, widgets VIS-2 (BoschCamera + BoschOverview), interfaz de administración JSON

Nodos de Node-RED

v0.4.2-alpha

Node-RED

Nodos de flujo para pipelines de automatización

Frontend (NiceGUI)

v0.4.2-alpha

aplicación web independiente

Panel de control + detalle de cámara + interfaz de configuración

Servidor MCP (este repositorio)

v1.7.1

Clientes Claude

Herramientas MCP invocables desde LLMs

Herramienta

Descripción

Devuelve

bosch_camera_list

Lista todas las cámaras configuradas

array of {id, name, model, hw_version, status}

bosch_camera_status

Obtiene el estado en línea/fuera de línea + privacidad de una cámara

{name, status, privacy_mode, light_on, last_event_at}

bosch_camera_snapshot

Captura JPEG solo LAN (sin nube) — HTTP Digest a la IP de la cámara

{path, method, timestamp}

bosch_camera_stream_url

URL de transmisión RTSPS solo LAN (sin retransmisión en la nube) — consumible por ffmpeg/VLC/go2rtc

{camera, rtsps_url, note}

bosch_camera_events

Lista eventos recientes de movimiento/persona/audio

array of {event_id, type, tags, timestamp_iso, has_clip, clip_status}

bosch_camera_privacy_set

Activa/desactiva el modo privacidad; prefer_local=True enruta a LAN RCP primero

{name, status, privacy_mode, ...}

bosch_camera_light_set

Activa/desactiva el foco; prefer_local=True enruta a LAN RCP primero

{name, status, light_on, ...}

bosch_camera_pan

Panorámica de la cámara 360° (solo Gen1 CAMERA_360); preset: inicio (0°) / izquierda (-60°) / derecha (+60°) / trasera-izquierda (-120°) / trasera-derecha (+120°)

{name, status, privacy_mode, light_on, last_event_at}

bosch_camera_notifications_set

Activa/desactiva notificaciones push

{name, status, privacy_mode, light_on, last_event_at}

bosch_camera_lan_ping

Sonda TCP a una cámara en el puerto LAN 443 (timeout de 1,5 s)

{reachable, ip, latency_ms}

bosch_camera_maintenance_status

Obtiene el anuncio actual de mantenimiento de la nube desde el feed RSS de la comunidad

{state, title, link, pub_date, summary, …, recommended_action}

bosch_camera_audio_get

Obtiene nivel de micrófono, nivel de altavoz, indicador de intercomunicador (solo Gen2)

{microphone_level, speaker_level, intercom_enabled}

bosch_camera_audio_set

Establece nivel de micrófono y/o nivel de altavoz 0-100 (solo Gen2)

{microphone_level, speaker_level, intercom_enabled}

bosch_camera_intrusion_get

Obtiene configuración de detección de intrusión: modo, sensibilidad 0-7, distancia 1-8 m (solo Gen2)

{mode, sensitivity, distance}

bosch_camera_intrusion_set

Actualiza modo/sensibilidad/distancia de detección de intrusión (solo Gen2)

{mode, sensitivity, distance}

bosch_camera_audio_detection_get

Obtiene configuración de detección de sonido de rotura de cristal + alarma de humo/incendio (solo Gen2 Audio-Plus)

{glass_break, fire_alarm}

bosch_camera_audio_detection_set

Actualiza detección de sonido de rotura de cristal y/o alarma de incendio (solo Gen2 Audio-Plus)

{glass_break, fire_alarm}

bosch_camera_wifi

Obtiene RSSI WiFi, SSID y calidad de señal derivada 0-100%

{rssi, ssid, signal_strength}

bosch_camera_mjpeg_snapshot

Instantánea MJPEG directa por LAN mediante RTSP inst=3 (solo Gen2, ffmpeg, sin ida y vuelta a la nube)

{path, method, timestamp, camera}

bosch_camera_onvif_scopes

Lee ámbitos de dispositivo ONVIF desde LAN RCP 0x0a98 de la cámara (solo Gen2)

{name, hardware, profiles, raw_scopes}

bosch_camera_rcp_version

Lee versión de biblioteca RCP desde opcodes LAN 0xff00 + 0xff04 de la cámara

{primary, secondary, raw_primary_hex, raw_secondary_hex}

bosch_camera_feature_flags

Obtiene indicadores de funciones de la nube Bosch a nivel de cuenta (sin parámetro de cámara)

{FLAG_NAME: bool, ...}

bosch_camera_siren_trigger

Activa la sirena interior (solo Gen2 Indoor II); stop=True para cancelar

{name, status, privacy_mode, light_on, last_event_at}

bosch_camera_motion_get

Obtiene estado de detección de movimiento habilitada + sensibilidad

{enabled, sensitivity}

bosch_camera_motion_set

Establece detección de movimiento habilitada y/o sensibilidad

{enabled, sensitivity}

bosch_camera_recording_get

Obtiene configuración de sonido de grabación en la nube

{sound_on}

bosch_camera_recording_set

Establece sonido de grabación en la nube

{sound_on}

bosch_camera_autofollow_get

Obtiene estado de seguimiento automático 360° (solo Gen1 Indoor)

{enabled}

bosch_camera_autofollow_set

Establece seguimiento automático 360° (solo Gen1 Indoor)

{enabled}

bosch_camera_privacy_sound_get

Obtiene estado de campanilla de privacidad audible

{enabled}

bosch_camera_privacy_sound_set

Establece estado de campanilla de privacidad audible

{enabled}

bosch_camera_unread_get

Obtiene número de eventos no leídos de una cámara

{count}

bosch_camera_health_check_all

Resumen de salud masivo para todas las cámaras (estado + WiFi + privacidad + último evento + no leídos)

array of per-camera health dicts

bosch_camera_token_status

Análisis local de JWT — devuelve validez, caducidad, correo electrónico (sin llamada de red)

{valid, expires_in_min, email}

bosch_camera_motion_zones_get

Lista rectángulos de zona de detección de movimiento (normalizados 0.0-1.0)

array of {x, y, w, h}

bosch_camera_motion_zones_set

Reemplaza todas las zonas de movimiento (reemplazo completo, no fusión)

array of {x, y, w, h}

bosch_camera_motion_zones_clear

Elimina todas las zonas de movimiento

[]

bosch_camera_privacy_masks_get

Lista rectángulos de zona de máscara de privacidad (normalizados 0.0-1.0)

array of {x, y, w, h}

bosch_camera_privacy_masks_set

Reemplaza todas las máscaras de privacidad (reemplazo completo, no fusión)

array of {x, y, w, h}

bosch_camera_privacy_masks_clear

Elimina todas las máscaras de privacidad

[]

bosch_camera_rules_list

Lista reglas de automatización (horario) para una cámara

array of {id, name, active, start, end, days}

bosch_camera_rules_add

Crea una nueva regla de horario

{id, name, active, start, end, days}

bosch_camera_rules_edit

Actualiza una regla existente (actualización parcial)

{id, name, active, start, end, days}

bosch_camera_rules_delete

Elimina una regla

{deleted, rule_id}

bosch_camera_friends_list

Lista amigos/invitaciones de uso compartido de cámara (a nivel de cuenta)

array of {id, email, nickname, status, shared_cameras}

bosch_camera_friends_invite

Invita a un amigo por correo electrónico (a nivel de cuenta)

{id, email, nickname, status, shared_cameras}

bosch_camera_friends_share

Comparte una cámara con un amigo existente (se fusiona con sus acciones existentes)

{shared, friend_id, camera}

bosch_camera_friends_unshare

Revoca todos los usos compartidos de cámara de un amigo

{unshared, friend_id}

bosch_camera_friends_remove

Elimina a un amigo por completo

{removed, friend_id}

bosch_camera_firmware_status

Obtiene versión de firmware actual/última + disponibilidad de actualización

{camera, current, up_to_date, update_available, installing}

bosch_camera_firmware_install

Instala la actualización de firmware pendiente (la cámara se reinicia en 3-7 min)

{camera, current, up_to_date, update_available, installing}

bosch_camera_siren_duration_set

Establece la duración de la alarma de sirena, 10-300 s (solo Gen2 Indoor II)

{alarm_delay_seconds}

bosch_camera_lighting_schedule_get

Obtiene el horario de iluminación LED (cámaras Eyes para exteriores)

{on_time, off_time, light_on_motion, darkness_threshold, schedule_status}

bosch_camera_lighting_schedule_set

Actualiza el horario de iluminación LED (cámaras Eyes para exteriores)

{on_time, off_time, light_on_motion, darkness_threshold, schedule_status}

bosch_camera_intercom_open

Abre una sesión de audio de escucha (micrófono de cámara → llamante); devuelve una URL RTSPS, solo escucha

{camera, rtsps_url, duration, speaker_level_set}

bosch_camera_timestamp_overlay_get

Obtiene si se graba una superposición de fecha/hora en el video

{enabled}

bosch_camera_timestamp_overlay_set

Activa/desactiva la superposición de fecha/hora en el video

{enabled}

bosch_camera_status_led_get

Obtiene el estado encendido/apagado del LED de estado de la cámara (solo Gen2)

{enabled}

bosch_camera_status_led_set

Enciende/apaga el LED de estado de la cámara (solo Gen2)

{enabled}

bosch_camera_lens_elevation_get

Obtiene la altura de montaje de la lente en metros (solo Gen2)

{meters}

bosch_camera_lens_elevation_set

Establece la altura de montaje de la lente, 0.5-5.0 m (solo Gen2)

{meters}

bosch_camera_darkness_threshold_get

Obtiene el umbral de iluminación día/noche + modo de atenuación (solo Gen2)

{threshold_percent, soft_light_fading}

bosch_camera_darkness_threshold_set

Establece el umbral de iluminación día/noche y/o modo de atenuación (solo Gen2)

{threshold_percent, soft_light_fading}

bosch_camera_white_balance_get

Obtiene el balance de blancos de la luz frontal, -1.0 frío .. 1.0 cálido (solo Gen2)

{value}

bosch_camera_white_balance_set

Establece el balance de blancos de la luz frontal (solo Gen2)

{value}

bosch_camera_led_brightness_get

Obtiene el brillo del LED superior o inferior 0-100 % (solo Gen2)

{position, brightness_percent}

bosch_camera_led_brightness_set

Establece el brillo del LED superior o inferior 0-100 % (solo Gen2)

{position, brightness_percent}

bosch_camera_soft_reset

Reinicia una cámara (reinicio suave)

{camera, rebooting}

bosch_camera_hard_reset

Restablecimiento de fábrica de una cámara — DESTRUCTIVO, desvincula la cámara; requiere confirm=True

{camera, factory_reset}

bosch_camera_rename

Renombra una cámara mediante la API de la nube

{camera, new_name}

URI de recurso

Descripción

bosch://cameras

Lista JSON de todas las cámaras (id, nombre, modelo, estado, firmware, mac, descripción)

bosch://cameras/{name}/snapshot.jpg

Último JPEG en caché, o captura fresca si la caché está vacía

bosch://cameras/{name}/events

Últimos 50 eventos (movimiento, persona, audio) como lista JSON

Prompt

Argumentos

Descripción

daily-camera-summary

hours: int = 24

Informe de varios pasos: eventos por cámara, desglose por tipo, distribución temporal, aspectos destacados de anomalías

pre-leave-check

(ninguno)

Instantánea de cada cámara, describir escena, marcar anomalías, recomendar modo de privacidad interior

Herramienta

Ruta

bosch_camera_snapshot

Solo LAN — HTTP Digest a la IP de la cámara

bosch_camera_stream_url

Solo LAN — RTSPS a través del proxy TLS local de Bosch

bosch_camera_lan_ping

Solo LAN — conexión TCP al puerto 443 de la cámara

bosch_camera_list / status / events

Nube de Bosch (sin API local todavía)

bosch_camera_privacy_set / light_set (predeterminado)

Nube de Bosch

bosch_camera_privacy_set / light_set (prefer_local=True)

LAN-RCP primero, respaldo en la nube — solo Gen2

bosch_camera_pan / notifications_set

Nube de Bosch (sin API local todavía)

Modo

Bandera

Caso de uso

stdio

--transport stdio (predeterminado)

Claude Code / Claude Desktop — subproceso local

streamable-http

--transport http

Implementaciones remotas / multi-cliente sobre HTTP

sse

--transport sse

Clientes SSE heredados

Todos los lanzamientos

Página de lanzamientos de GitHub — cada versión etiquetada con notas + recursos descargables

Historial completo

CHANGELOG.md — las mismas notas, navegables dentro del repositorio

Característica

Home Assistant Integration

Python CLI Tool

ioBroker Adapter

MCP Server

Frontend (NiceGUI)

Node-RED

Madurez

v15.0+ — Escala de Calidad de HA Platinum

v10.12+ estable (Mini-NVR BETA)

v1.8+ estable · npm

v1.7+ estable · PyPI

v0.4.0 alpha · PyPI

v0.4.0 alpha · npm

Plataforma

Home Assistant (HACS)

CLI independiente de Python 3.10+

ioBroker (npm)

Python 3.10+ · pipx / uvx · stdio + streamable-HTTP para clientes MCP (Claude Desktop, Claude Code, personalizados)

Aplicación web NiceGUI · Python 3.10+

Paleta Node-RED · npm

Inicio de sesión

OAuth2 PKCE (navegador)

OAuth2 PKCE (navegador)

OAuth2 PKCE (navegador)

◑ comparte bosch_config.json de la CLI

◑ comparte bosch_config.json de la CLI

◑ token de actualización desde la CLI

Instantáneas

✅ Camera.image nativo

✅ comando snapshot

✅ Almacenamiento de archivos + DP base64

✅ bosch_camera_snapshot (solo LAN)

✅ en vivo + respaldo de eventos

✅ nodo snapshot

Transmisión RTSP en vivo (LAN)

✅ mediante el componente HA Stream

✅ salida ffmpeg/RTSPS

✅ proxy TLS → RTSP local

✅ bosch_camera_stream_url (solo LAN, sin retransmisión en la nube)

◑ interno (go2rtc)

◑ nodo stream-url (solo URL)

WebRTC (latencia de menos de un segundo)

✅ mediante go2rtc integrado

✅ (v10.6.0) live --webrtc

❌

❌

✅ mediante go2rtc (si no, instantánea)

❌

URL de doble transmisión (principal + secundaria)

✅ sensor.bosch_<n>_stream_url + _sub (v12.4.0, opt-in por cámara)

✅ info muestra ambas · live --sub (v10.5.0)

✅ stream_url + stream_url_sub (v0.5.3 experimental)

◑ bosch_camera_stream_url — solo transmisión principal

❌ (solo transmisión secundaria)

◑ Solo URL — sin opción secundaria

Grabador externo (BlueIris, Frigate)

✅ mediante go2rtc

✅ tubería stdout

✅ URL con credenciales Digest + opción de enlace LAN

✅ URL devuelta, transferencia a ffmpeg / go2rtc posterior

❌

◑ stream-url → conectar posteriormente

Modo privacidad

✅ entidad de interruptor

✅ comando

✅ DP

✅ bosch_camera_privacy_set (respaldo LAN mediante prefer_local)

✅ alternar

✅ nodo privacy

Foco frontal (Gen1/Gen2)

✅ entidad de luz

✅ comando

✅ DP

✅ bosch_camera_light_set (respaldo LAN)

❌ (esquema de la Fase 2)

✅ nodo bosch-camera-light (v0.3.0-alpha)

Lavaparedes RGB (Gen2 Outdoor II)

✅ luz con RGB

◑ solo encendido/apagado — sin RGB

✅ DP de color + brillo

❌ (solo encendido/apagado — RGB no expuesto)

❌

◑ solo encendido/apagado + intensidad — sin RGB (v0.3.0-alpha)

Sirena de alarma de pánico

✅ entidad de botón (Gen2 Indoor II)

✅ comando (solo Gen2 Indoor II)

✅ DP

✅ bosch_camera_siren_trigger (solo Gen2 Indoor II)

✅ activación + duración (solo Gen2 Indoor II)

❌

Actualización de firmware

✅ Entidad de actualización + flujo de reparación de Repairs, botón de instalación (v14.4.10)

✅ estado + instalación (v10.11.0)

✅ estados de firmware + activación de instalación, protección de bloqueo de escritura (v1.8.0)

✅ estado + herramientas de instalación (v1.7.0)

◑ visualización de estado de solo lectura, sin acción de instalación

✅ nodos de estado + instalación (v0.4.0-alpha)

Rotación de imagen 180°

✅ interruptor

❌

✅ DP

❌

❌

❌

Eventos de movimiento / persona / audio

✅ push FCM + respaldo de sondeo

◑ solo comando watch (comando de eventos eliminado)

✅ push FCM + respaldo de sondeo

✅ bosch_camera_events (extracción bajo demanda)

◑ tabla de eventos solo de extracción

✅ nodo event (sondeo)

Estado de activación por flanco de movimiento

✅ binary_sensor.motion

n/a

✅ motion_active DP (v0.5.3)

n/a (solicitud-respuesta, sin suscripción)

❌

❌

Instantánea automática al detectar movimiento

✅ actualiza la entidad Camera

n/a

✅ escribe last_event_image en base64 (v0.5.3)

n/a (sin bucle en segundo plano)

❌

❌

Activación de movimiento sintético (sensor externo)

✅ servicio

n/a

✅ DP

❌

❌

❌

Zonas de movimiento / máscaras de privacidad

✅ lectura + escritura

✅ lectura + escritura

✅ lectura + escritura (v1.8.0)

✅ obtener / establecer / borrar (v1.7.0)

❌ (aún sin editor visual)

❌

Reglas de automatización / programaciones

✅ lectura + escritura

✅ lectura + escritura

✅ CRUD completo (v1.8.0)

✅ listar / añadir / editar / eliminar (v1.7.0)

✅ CRUD completo (listar/añadir/editar/eliminar)

❌

Programación de iluminación

✅ lectura (escritura mediante servicio, solo Gen1 Eyes Outdoor)

✅ lectura + escritura

✅ lectura (solo Gen1, v1.2.0)

✅ obtener / establecer (v1.7.0)

✅ lectura + escritura (cámaras Eyes de exterior)

❌

Descarga de clips en la nube (historial ~30 días)

✅ mediante Media Browser

❌

❌ (en pausa — aún sin solicitud de la comunidad)

❌ (intencionalmente no expuesto — cargas grandes)

❌ (use la CLI)

◑ clip_url en la carga del evento

Mini-NVR (grabación local)

✅ continua + con búfer de eventos, preroll de búfer circular (v11.2.0 BETA → modos v14.7.0)

◑ multiplexado de segmentos activado por eventos, sin anillo de preroll (v10.7.0 BETA)

❌ (delega en un grabador externo mediante un endpoint RTSP sin credenciales)

❌ (sin concepto de NVR)

◑ solo continua, sin búfer de eventos (v0.4.0-alpha)

◑ solo continua mediante el nodo bosch-camera-nvr-record (v0.4.0-alpha)

Carga de clips SMB / NAS

✅

✅ (v10.7.0 BETA)

❌

❌

❌

❌

Compartir cámara (amigos)

✅ servicios (compartir / invitar / listar)

✅ comando

✅ compartir / invitar / eliminar (solo Gen2, v1.8.0)

✅ listar / invitar / compartir / dejar de compartir / eliminar (v1.7.0)

✅ listar/invitar/eliminar/compartir/dejar de compartir

❌

Panorámica / inclinación (360° Gen1)

✅ servicios

✅ comando

✅ pan_position DP

✅ bosch_camera_pan

✅ control deslizante conectado a la API en vivo

❌

Preajustes de panorámica con nombre (home / left / right / back-left / back-right)

✅ entidad de selección opt-in

✅ indicador pan --preset

✅ pan_preset DP

✅ bosch_camera_pan preset=

❌

❌

Audio bidireccional / intercomunicador

❌

✅ comando

❌

◑ solo escucha bosch_camera_intercom_open (v1.7.0)

❌

❌

Entrega de webhooks en eventos

✅ servicio + opciones opt-in

✅ watch --webhook URL

✅ mediante puente MQTT

❌ (modelo de solicitud-respuesta)

❌

❌

Puente de eventos MQTT (movimiento / audio / persona)

n/a (bus de eventos nativo de HA)

n/a (ejecución única)

✅ configuración de administrador

n/a

❌

❌

Apple HomeKit (mediante puente HA Core)

✅ documentado

n/a

n/a

n/a

n/a

n/a

Programador de instantáneas / time-lapse

✅ ejemplos/ YAML

✅ ejemplos de cron + ffmpeg

✅ ejemplo de Blockly

n/a

❌

❌

Tarjeta / widget nativo de panel

✅ 2 tarjetas Lovelace (individual + cuadrícula)

n/a

✅ 2 widgets vis-2 — BoschCamera + BoschOverview multicámara

n/a

✅ (es en sí mismo un panel web)

❌

Picture-in-Picture sobrevive a la pestaña en segundo plano

✅ keep-alive hass-suspend-when-hidden (v14.0.0)

n/a (sin interfaz)

✅ PiP propio + recuperación de congelación, latido de Web-Worker (v1.7.2/v1.7.3)

n/a (sin interfaz)

✅ tiempo de espera de reconexión + recuperación de congelación (v0.4.0-alpha)

n/a (sin interfaz)

Respaldo REMOTO de retransmisión en la nube

✅ cambio automático cuando la LAN no está disponible

✅ modo remoto

❌ (solo LOCAL por diseño)

❌ (multimedia solo LAN; estado/eventos mediante la nube)

◑ hereda de la CLI

◑ opción REMOTO (manual)

Interfaz de administración / configuración basada en navegador

✅ Flujo de configuración de HA

n/a (CLI)

✅ pestañas de configuración JSON

n/a (mediado por LLM; configuración mediante CLI / cliente MCP)

✅ página de configuración

◑ nodo de configuración del editor

Idiomas de la interfaz

EN · DE · FR · ES · IT · NL · PL · PT · RU · UK · ZH-Hans (v12.4.0)

EN · DE · FR · ES · IT · NL · PL · PT · RU · UK · ZH-Hans (v10.3.0)

EN · DE · FR · ES · IT · NL · PL · PT · RU · UK · ZH-CN

n/a (sin interfaz — el LLM es el front-end)

◑ i18n del backend · interfaz mayormente en EN

n/a (solo inglés)

Implementación

Repositorio

Estado

🏆 Integración con Home Assistant

Bosch-Smart-Home-Camera-Tool-HomeAssistant

v16.0.1 · HA Quality Scale Platinum · listo para producción

🐍 CLI de Python

Bosch-Smart-Home-Camera-Tool-Python

v10.12.3 · Mini-NVR + carga SMB (BETA) · respaldo LAN (ping / --local) · presets PTZ · entrega por webhook · captura / investigación / independiente

🟢 Adaptador ioBroker

ioBroker.bosch-smart-home-camera

v1.8.3 · estable · npm · rotación de Digest con interruptor de privacidad · puente MQTT · presets PTZ · widgets VIS-2 (BoschCamera + BoschOverview)

🤖 Servidor MCP (este repositorio)

Bosch-Smart-Home-Camera-Tool-MCP

v1.7.2 · rotación de credenciales · presets PTZ · fijación de certificados TOFU · CA de nube fijada (CWE-295) · ping LAN + prefer_local · zonas/máscaras/reglas/amigos/instalación de firmware · integración con Claude Code / Claude Desktop

🔴 Nodos Node-RED (alfa)

Bosch-Smart-Home-Camera-Tool-NodeRED

v0.4.2-alpha · nodos para evento / instantánea / privacidad / configuración / más