Servidor MCP de SwitchBot

@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

Install Server

HTTP connection URL

You must to connect to the server.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

Related MCP Servers

CodeSavant
twolven
-
security
A
license
-
quality
Provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
Last updated -
8
Python
MIT License
Browser Automation MCP Server
grapheneaffiliate
-
security
F
license
-
quality
Enables AI agents to control web browsers via a standardized interface for operations like launching, interacting with, and closing browsers.
Last updated -
0
JavaScript
ClickUp MCP Server
taazkareem
A
security
A
license
A
quality
Enables AI integrations with ClickUp tasks, supporting resource management, task operations, workspace organization, and AI-powered task recommendations through a standardized protocol.
Last updated -
18
605
201
TypeScript
MIT License
Home Assistant MCP
guilhermelirio
-
security
A
license
-
quality
Provides tools for AI assistants to interact with smart home devices through Home Assistant, allowing operations like checking entity states and calling services.
Last updated -
TypeScript
MIT License

View all related MCP servers

SwitchBot MCP Server