SwitchBot MCP Server

Controle dispositivos SwitchBot de forma interativa usando a API SwitchBot.

Documentação

SwitchBot MCP Server

Go Report Card Coverage Code to Test Ratio Test Execution Time

Versão em japonês

O SwitchBot MCP Server é um servidor Model Context Protocol (MCP) que fornece um recurso para controlar dispositivos SwitchBot de forma interativa usando SwitchBotAPI.

Casos de Uso

  • Operar dispositivos SwitchBot interativamente
  • Realizar operações em vários dispositivos ao mesmo tempo
  • Usar dados recuperados de um dispositivo para operar outro dispositivo

Instalação

Preparar secret e token

Siga o guia de introdução da SwitchBotAPI para obter o token e o secret da SwitchBotAPI.

Configuração para o Claude Desktop

Usando Docker (recomendado)

{
  "mcpServers": {
    "switchbot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--name",
        "switch-bot-mcp-server",
        "-e",
        "SWITCH_BOT_TOKEN",
        "-e",
        "SWITCH_BOT_SECRET",
        "yasu89/switch-bot-mcp-server:latest"
      ],
      "env": {
        "SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN",
        "SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET"
      }
    }
  }
}

Usando binário

Detalhes

Baixe o binário da página de releases.

{
  "mcpServers": {
    "switchbot": {
      "command": "~/Downloads/switch-bot-mcp-server",
      "env": {
        "SWITCH_BOT_TOKEN": "YOUR_SWITCH_BOT_TOKEN",
        "SWITCH_BOT_SECRET": "YOUR_SWITCH_BOT_SECRET"
      }
    }
  }
}

Ferramentas Disponíveis

Recuperação de dispositivos, recuperação de status e execução de comandos em dispositivos estão disponíveis.

Nome da FerramentaDescrição
get_switch_bot_devicesObter dispositivos SwitchBot
get_switch_bot_device_statusObter status do dispositivo SwitchBot
execute_commandExecutar um comando em um dispositivo