切换器MCP服务器
一个Node.js MCP（模型上下文协议）服务器，通过Claude Desktop或Home Assistant公开SwitchBot温度传感器进行监控。
特性
- 设备发现：自动发现所有SwitchBot设备（Meter、MeterPlus、WoIOSensor、Plug Mini、Bot）
- 温度监测：从任何传感器读取温度和湿度
- 能源监测：从Plug Mini设备读取功率、电压和电流（UPS/负载监测）
- 切换：打开/关闭插头，按下机器人手指模拟器
- 灵活单位：支持华氏和摄氏温度
- 设备查找：按ID或昵称查找设备（不区分大小写）
- 双重运输：支持stdio（克劳德桌面）和HTTP/SSE（家庭助理）
- 请求日志记录：可选记录所有调试工具调用
安装
cd switchr-mcp
npm install配置
SwitchBot凭据
SwitchBot API凭据由管理 @caseman72/切换器api 通过 .env.local。在以下位置搜索文件：
- 当前工作目录
~/.config/switchr-api/.env.local~/.switchbot.env.local
创建一个 .env.local 包含您的SwitchBot凭据的文件：
SWITCHBOT_TOKEN=your-switchbot-token
SWITCHBOT_SECRET=your-switchbot-secret访问 SwitchBot开发人员门户 以获取您的API证书。
服务器配置（可选）
复制 config.example.json 到 config.json 要自定义服务器设置，请执行以下操作：
{
"server": {
"transport": "stdio",
"httpPort": 8001,
"httpHost": "127.0.0.1"
},
"devices": {
"refreshIntervalMinutes": 60
},
"monitoring": {
"enabled": false,
"logFile": "./switchr-mcp-requests.log"
}
}用法
stdio传输（克劳德桌面）
node src/index.jsHTTP传输（家庭助理）
HA自定义组件要求MCP服务器通过HTTP/SSE公开。使用 mcp-proxy 桥接stdio服务器。
安装mcp代理
brew install mcp-proxy启动代理
# Binds to all interfaces so Docker can reach it
mcp-proxy --port 8082 --host 0.0.0.0 -- node /path/to/switchr-mcp/src/index.js家庭助理集成
- 将自定义组件复制到HA配置目录：
cp -r custom_components/switchr_mcp ~/.home-assistant/custom_components/- 重新启动家庭助理
- 添加集成：设置→ 设备和服务→ 添加集成→ “切换器MCP”
- 输入连接详细信息：
- 主持人： host.docker.internal （适用于Docker）或Mac的IP - 端口： 8082
创建的实体
- 温度传感器 (
Meter,MeterPlus,WoIOSensor)：每个设备一个组合实体，温度为原始值，湿度/电池为属性。 - 迷你插头：四个传感器加一个开关--
PowerWVoltage五、Current（mA），Energy（kWh），以及switch.（开/关控制）。Energy实体通过以下方式在轮询之间集成瞬时电源，并在HA重启期间持续供电RestoreEntity，因此它可以直接在HA Energy仪表板中使用，而无需Riemann助手。 - 机器人 （手指模拟器）：
button._press--发送瞬时按压（伸出然后缩回）。适用于pressMode机器人。
使用launchd自动启动mcp代理
创建 ~/Library/LaunchAgents/com.switchr.mcp-proxy.plist:
Label
com.switchr.mcp-proxy
ProgramArguments
/opt/homebrew/bin/mcp-proxy
--port
8082
--host
0.0.0.0
--
/opt/homebrew/bin/node
/path/to/switchr-mcp/src/index.js
WorkingDirectory
/path/to/switchr-mcp
RunAtLoad
KeepAlive
StandardOutPath
/tmp/switchr-mcp-proxy.log
StandardErrorPath
/tmp/switchr-mcp-proxy.err
然后加载它：
launchctl load ~/Library/LaunchAgents/com.switchr.mcp-proxy.plist要停止/卸载：
launchctl unload ~/Library/LaunchAgents/com.switchr.mcp-proxy.plist管理服务
# Check status
launchctl list | grep switchr
# View logs
tail -f /tmp/switchr-mcp-proxy.err
# Restart
launchctl unload ~/Library/LaunchAgents/com.switchr.mcp-proxy.plist
launchctl load ~/Library/LaunchAgents/com.switchr.mcp-proxy.plist
# Stop
launchctl unload ~/Library/LaunchAgents/com.switchr.mcp-proxy.plistClaude桌面集成
添加 ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"switchr": {
"command": "node",
"args": ["/path/to/switchr-mcp/src/index.js"],
"env": {}
}
}
}MCP工具
list_devices
列出所有发现的SwitchBot设备。可选过滤器，仅显示温度传感器。
参数：
sensorsOnly（可选）：如果为真，则仅返回温度传感器（Meter、MeterPlus、WoIOSensor）refresh（可选）：从SwitchBot API强制刷新设备列表
get_device_status
获取任何SwitchBot设备的详细状态。返回设备特定的属性，如电源状态、电池电量等。
参数：
deviceId：设备ID或设备名称
get_temperature
从特定的SwitchBot温度传感器获取温度和湿度读数。
参数：
deviceId：温度传感器的设备ID或设备名称unit（可选）：温度单位-F对于华氏温度（默认），C摄氏度
答复包括：
temperature：请求单位中的当前温度humidity：当前湿度百分比battery：电池电量百分比
get_all_temperatures
一次从所有SwitchBot温度传感器获取温度和湿度读数。
参数：
unit（可选）：温度单位-F对于华氏温度（默认），C摄氏度
get_plug_status
从SwitchBot Plug Mini获取电源状态和能量数据。用于UPS/能源监控。
参数：
deviceId：插头的设备ID或设备名称
答复包括：
power:"on"或"off"voltage：伏特watts：瞬时功率消耗（W）currentMilliamps：电流消耗（mA）electricityOfDay：设备今天的准时蓄能器
get_all_plugs
同时从所有SwitchBot Plug Mini设备获取电源和能量读数。
turn_on / turn_off
打开/关闭SwitchBot Plug Mini（或处于切换模式的Bot）。
参数：
deviceId：设备ID或设备名称
press_bot
向SwitchBot Bot（手指模拟器）发送瞬时按压。手指伸出然后缩回。
参数：
deviceId：Bot的设备ID或设备名称
get_api_status
获取SwitchBot API速率限制状态。返回剩余调用、重置时间和缓存信息。
答复包括：
rate_limit.remaining：剩余API调用rate_limit.reset_by：当速率限制重置时cache.last_refresh：上次刷新设备的时间cache.device_count：发现的设备总数cache.sensor_count：发现温度传感器
请求监控
在config.json中启用请求日志：
{
"monitoring": {
"enabled": true,
"logFile": "./switchr-mcp-requests.log"
}
}日志以JSON Lines格式编写，包含时间戳、工具名称、参数和结果。
许可证
麻省理工学院