@genm/switchbot-mcp

Un servidor de protocolo de contexto de modelo que proporciona capacidades de control de dispositivos SwitchBot a los asistentes de IA.

Japonés

Características

• Lista de dispositivos

• Obtener el estado del dispositivo

• Dispositivos de control (encendido/apagado)

• Cambiar la configuración del dispositivo

• Control de escena

• Monitoreo del estado del dispositivo

Related MCP server: Home Assistant MCP

Instalación

Instalación mediante herrería

Para instalar SwitchBot MCP Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Configuración

1. Configuración de la API de SwitchBot

1. Instalar la aplicación SwitchBot

2. Crea una cuenta e inicia sesión

3. Vaya a Perfil > Configuración > Opciones de desarrollador

4. Obtenga tanto el token como la clave secreta

2. Configuración del servidor MCP

Agregue lo siguiente a claude_desktop_config.json :

3. Variables de entorno

Dispositivos compatibles

• Enchufar

  • Lámpara de pie para sala de estar

  • Fuente de alimentación para PC de oficina

• Bot

  • Cafetera de cocina

  • Purificador de aire para sala de estar

• Cortina

  • Cortina de ventana del dormitorio

  • Cortina opaca para sala de estudio

• Acondicionador de aire

  • Aire acondicionado de la sala de estar

  • Aire acondicionado del dormitorio

• Humidificador

  • Humidificador de dormitorio

  • Humidificador para sala de estudio

• Luz

  • Lámpara de techo de cocina

  • Luz de noche para dormitorio

• Mando a distancia

  • Televisión de la sala de estar

  • Ventilador de sala de estudio

Ejemplos de nombres de dispositivos

Se recomienda asignar nombres descriptivos a sus dispositivos para facilitar su control por parte de los asistentes de IA. Ejemplos:

• "Cortina de dormitorio" en lugar de solo "Cortina"

• "Aire acondicionado de la sala" en lugar de solo "Aire acondicionado"

• "Cafetera de cocina" en lugar de simplemente "Bot"

Esta convención de nomenclatura ayuda a los asistentes de IA a comprender el contexto y la ubicación de cada dispositivo.

Operaciones apoyadas

Administración de dispositivos

• Lista de dispositivos

• Obtener el estado del dispositivo

• Encender/apagar dispositivos

• Cambiar la configuración del dispositivo

Gestión de escenas

• Lista de escenas

• Ejecutar escenas

Información del sensor

• Temperatura

• Humedad

• Brillo

• Movimiento

Desarrollo

Solución de problemas

El dispositivo no responde

1. Verifique que el dispositivo esté dentro del alcance de Bluetooth

2. Comprobar el estado de la batería del dispositivo

3. Verificar el estado de la conexión del concentrador SwitchBot

Errores de autenticación

1. Comprobar la expiración del token y la clave secreta

2. Regenerar token y clave secreta

3. Actualizar variables de entorno

Licencia

ISC