Temp Stick (by OpenPandora)

tempstick-mcp

mcp-name: io.github.obseard223/tempstick-mcp

OpenPandora 提供的 Temp Stick MCP 服务——让 AI 助手查看冰箱和温度传感器。

刚接触这个项目？ 请参阅简明设置指南——五分钟即可完成，步骤简短，无需了解专业术语。

tempstick-mcp 是一个免费、开源的 Model Context Protocol（MCP）服务， 适用于 Ideal Sciences 的 Temp Stick WiFi 温度传感器—— 让 AI 助手监控冷冻柜并读取温度传感器。它最初是为餐厅厨房打造的（没人想在早上 6 点发现冷藏库已经变暖），但只要 Temp Stick 监测着重要对象，它就能派上用场：冷冻柜、冰箱、服务器机房、温室、住宅。将它连接到 Claude、Cursor 或任意 MCP 客户端，然后直接提问：

“现在我的冷冻柜温度是多少？” “今天冷藏库的温度是否超过了 40°F？” “有没有传感器离线或电量不足？”

服务会通过官方 Temp Stick API 返回实时数据： 温度（摄氏度和华氏度）、湿度、电池电量、离线状态、 警报定义以及近期读数摘要。

• 零依赖。 纯 Python 3 标准库——无需 pip install 任何内容。克隆、添加密钥，即可使用。
• 只读。 它无法更改你账户中的设置、阈值或警报。
• 设计上注重隐私。 你的 API 密钥通过环境变量保存在本机。服务只与 tempstickapi.com 通信。

工具

工具	返回内容
list_sensors	你的密钥可访问的所有传感器，以及各传感器最新的温度、湿度、电池电量和离线状态。
get_sensor	一个传感器的最新读数（通过 sensor_id 指定）。
get_freezer_status	一次调用即可检查一个传感器：同时返回最新读数、近期历史摘要和警报定义。名称源自经典的冷冻柜使用场景；也适用于任何传感器。
get_readings_history	一个传感器近期读数的摘要：数量、温度最低值／最高值／平均值，以及首次和最近一次读数的时间。
get_alerts	账户的警报定义及其是否已触发。

此外还附带一个命令行版本，供终端检查和 cron 任务使用： tempstick.py list-sensors、latest --sensor <ID>、history --sensor <ID>、 alerts、freezer --sensor <ID>。

获取 API 密钥

1. 登录 mytempstick.com。
2. 打开 Account Page。
3. 选择 Developers 选项卡。
4. 点击 Show Key，查看 API 密钥。

（依据 Temp Stick 官方开发者文档。）

安装

git clone https://github.com/obseard223/tempstick-mcp

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json（macOS： ~/Library/Application Support/Claude/claude_desktop_config.json； Windows：%APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "tempstick": {
      "command": "python3",
      "args": ["/path/to/tempstick-mcp/server.py"],
      "env": { "TEMPSTICK_API_KEY": "paste-your-key-here" }
    }
  }
}

重启 Claude Desktop，然后提问：“列出我的 Temp Stick 传感器。”

Claude Code

claude mcp add tempstick \
  --env TEMPSTICK_API_KEY=paste-your-key-here \
  -- python3 /path/to/tempstick-mcp/server.py

Cursor

将以下内容添加到项目中的 .cursor/mcp.json（或全局 MCP 配置）：

{
  "mcpServers": {
    "tempstick": {
      "command": "python3",
      "args": ["/path/to/tempstick-mcp/server.py"],
      "env": { "TEMPSTICK_API_KEY": "paste-your-key-here" }
    }
  }
}

在 Windows 上，请使用 python 替代 python3（并使用 Windows 风格的路径）。

离线测试

无需密钥，也无需网络：

python3 selftest.py            # full end-to-end test against a stub API
python3 tempstick.py selftest  # parsing/unit checks only

两项测试都应以 PASS 结束。

API 说明

此服务为你处理了 Temp Stick API 的一些行为：

• 错误会以 HTTP 200 和 JSON 封装体（type: "error"）的形式返回，因此服务会检查封装体并显示真实错误消息，例如 Invalid X-API-KEY。
• 温度以摄氏度返回；每个读数也会以华氏度报告。
• API 主机会拒绝非浏览器的用户代理，因此服务会发送浏览器用户代理。

状态

这是一个基于 Temp Stick 官方 API 构建的社区项目，与 Ideal Sciences 或 Temp Stick 无关，也未获其认可。解析和协议层通过离线固定数据测试（参见 selftest.py）；对于文档未说明的读数和警报数据结构，服务会采取防御性解析。

由 OpenPandora 构建

由 OpenPandora 构建——为独立餐厅打造的 AI 工具。这款传感器监控工具也在监测我们试点厨房的步入式冷冻室，我们免费发布它，让每位拥有 Temp Stick 的运营者都能向自己的 AI 咨询相关信息。

许可证

MIT——详见 LICENSE。