Switchbot

🚀 @genm/switchbot-mcp

本項目是一個提供SwitchBot設備控制能力的模型上下文協議（MCP）服務器，藉助它，AI助手能夠對SwitchBot設備進行控制，為智能家居控制帶來了新的便利。

日本語版

🚀 快速開始

本項目旨在為AI助手提供控制SwitchBot設備的能力，下面將為你介紹如何安裝和配置該服務器。

✨ 主要特性

• 設備管理：可列出設備、獲取設備狀態、控制設備開關以及調整設備設置。
• 場景控制：支持列出場景和執行場景操作。
• 狀態監控：能監控設備狀態，獲取溫度、溼度、明亮度和運動感應等傳感器信息。

📦 安裝指南

使用Smithery安裝

通過Smithery可自動安裝SwitchBot MCP服務器並以Claude Desktop運行，執行以下命令：

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

支持的設備

• 插座：
  • 客廳地燈
  • 辦公室電腦電源
• 機器人：
  • 廚房咖啡機
  • 客廳空氣淨化器
• 窗簾：
  • 臥室窗飾
  • 書房遮光窗簾
• 空調：
  • 客廳空調
  • 臥室空調
• 加溼器：
  • 臥室加溼器
  • 書房加溼器
• 燈具：
  • 廚房主燈
  • 臥室夜燈
• 遙控設備：
  • 客廳電視
  • 書房風扇

設備命名示例

為了便於AI助手理解，建議為設備提供描述性名稱。例如：

• “臥室窗簾”而不是“窗簾”
• “客廳空調”而不是“空調”

這種命名習慣有助於AI助手識別設備的位置和用途。

支持的操作

設備管理

• 列出設備
• 獲取設備狀態
• 控制設備開關
• 調整設備設置

場景管理

• 列出場景
• 執行場景

傳感器信息

• 溫度
• 溼度
• 明亮度
• 運動感應

開發

# 構建
npm run build

# 開發模式（TypeScript）
npm run dev

# 啟動
npm start

故障排除

設備無響應

1. 確認設備在藍牙範圍內。
2. 檢查設備電池狀態。
3. 確認SwitchBot中繼器連接狀態。

認證錯誤

1. 檢查令牌和密鑰的有效期。
2. 重新生成令牌和密鑰。
3. 更新環境變量。

📄 許可證

ISC