remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides connectivity for SwitchBot devices which operate over Bluetooth, allowing device control for devices within Bluetooth range.

@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

Instalación

Instalación mediante herrería

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

npx -y @smithery/cli install @genm/switchbot-mcp --client claude

Instalación manual

npm install @genm/switchbot-mcp

Configuración

1. Configuración de la API de SwitchBot

Instalar la aplicación SwitchBot
Crea una cuenta e inicia sesión
Vaya a Perfil > Configuración > Opciones de desarrollador
Obtenga tanto el token como la clave secreta

2. Configuración del servidor MCP

Agregue lo siguiente a claude_desktop_config.json :

{
  "mcpServers": {
    "switchbot": {
      "command": "node",
      "args": ["path/to/switchbot-mcp/build/index.js"],
      "env": {
        "SWITCHBOT_TOKEN": "your_token",
        "SWITCHBOT_SECRET": "your_secret"
      }
    }
  }
}

3. Variables de entorno

SWITCHBOT_TOKEN=your_token
SWITCHBOT_SECRET=your_secret

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

# Build
npm run build

# Development mode (TypeScript)
npm run dev

# Start
npm start

Solución de problemas

El dispositivo no responde

Verifique que el dispositivo esté dentro del alcance de Bluetooth
Comprobar el estado de la batería del dispositivo
Verificar el estado de la conexión del concentrador SwitchBot

Errores de autenticación

Comprobar la expiración del token y la clave secreta
Regenerar token y clave secreta
Actualizar variables de entorno

Licencia

ISC

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Permite que los asistentes de IA controlen dispositivos SwitchBot, proporcionando funcionalidades como administración de dispositivos, ejecución de escenas y monitoreo de información de sensores a través de la API de SwitchBot.

Related Resources

Reddit Discussion about this server