Skip to main content
Glama

SwitchBot MCP Server

by genm

@genm/スイッチボット-mcp

AI アシスタントに SwitchBot デバイス制御機能を提供するモデル コンテキスト プロトコル サーバー。

日本語

特徴

  • デバイスの一覧
  • デバイスのステータスを取得する
  • 制御デバイス(オン/オフ)
  • デバイス設定を変更する
  • シーンコントロール
  • デバイスステータス監視

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の SwitchBot MCP Server を自動的にインストールするには:

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

手動インストール

npm install @genm/switchbot-mcp

設定

1. SwitchBot API設定

  1. SwitchBotアプリをインストールする
  2. アカウントを作成してサインインする
  3. プロフィール > 設定 > 開発者向けオプションに移動します
  4. トークンと秘密鍵の両方を取得する

2. MCPサーバーの構成

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. 環境変数

SWITCHBOT_TOKEN=your_token SWITCHBOT_SECRET=your_secret

対応デバイス

  • プラグ
    • リビングルームのフロアランプ
    • オフィスPC電源
  • ボット
    • キッチンコーヒーメーカー
    • リビングルーム用空気清浄機
  • カーテン
    • 寝室の窓のカーテン
    • 勉強部屋用遮光カーテン
  • エアコン
    • リビングルームのエアコン
    • 寝室のエアコン
  • 加湿器
    • 寝室用加湿器
    • 勉強部屋用加湿器
  • ライト
    • キッチンの天井照明
    • 寝室のナイトライト
  • リモコン
    • リビングルームのテレビ
    • 勉強部屋用扇風機

デバイス名の例

AIアシスタントによる制御を容易にするために、デバイスにわかりやすい名前を付けることをお勧めします。例:

  • 「カーテン」ではなく「寝室のカーテン」
  • 「エアコン」ではなく「リビングルームAC」
  • 「ボット」ではなく「キッチンコーヒーメーカー」

この命名規則は、AI アシスタントが各デバイスのコンテキストと場所を理解するのに役立ちます。

サポートされている操作

デバイス管理

  • デバイスの一覧
  • デバイスのステータスを取得する
  • デバイスのオン/オフ
  • デバイス設定を変更する

シーン管理

  • シーン一覧
  • シーンを実行する

センサー情報

  • 温度
  • 湿度
  • 輝度
  • モーション

発達

# Build npm run build # Development mode (TypeScript) npm run dev # Start npm start

トラブルシューティング

デバイスが応答しません

  1. デバイスがBluetoothの範囲内にあることを確認してください
  2. デバイスのバッテリー状態を確認する
  3. SwitchBotハブの接続ステータスを確認する

認証エラー

  1. トークンと秘密鍵の有効期限を確認する
  2. トークンと秘密鍵を再生成する
  3. 環境変数を更新する

ライセンス

ISC

Install Server

You must to connect to the server.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

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

AI アシスタントが SwitchBot デバイスを制御できるようにし、SwitchBot API を通じてデバイス管理、シーン実行、センサー情報の監視などの機能を提供します。

  1. 特徴
    1. インストール
      1. Smithery経由でインストール
      2. 手動インストール
    2. 設定
      1. SwitchBot API設定
      2. MCPサーバーの構成
      3. 環境変数
    3. 対応デバイス
      1. デバイス名の例
        1. サポートされている操作
          1. デバイス管理
          2. シーン管理
          3. センサー情報
        2. 発達
          1. トラブルシューティング
            1. デバイスが応答しません
            2. 認証エラー
          2. ライセンス

            Related MCP Servers

            • -
              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
            • -
              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
            • 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
              • Linux
              • Apple
            • -
              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

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/genm/switchbot-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server