Temp Stick (by OpenPandora)

tempstick-mcp

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

OpenPandora の Temp Stick MCP サーバー — AI アシスタントで冷凍庫や温度センサーを確認できます。

初めての方へ やさしい言葉で書かれたセットアップガイドをご覧ください — 5 分でできる、短い手順で、専門用語はありません。

tempstick-mcp は、Ideal Sciences の Temp Stick WiFi 温度センサー向けの無料のオープンソース Model Context Protocol（MCP）サーバーです。AI アシスタントで冷凍庫を監視し、温度センサーの測定値を取得できます。レストランの厨房向けに開発されました（午前 6 時にウォークイン冷蔵庫が温まっていると気づくのは誰だって避けたいものです）。そして、Temp Stick が大切なものを監視している場所ならどこでも使えます。冷凍庫、冷蔵庫、サーバールーム、温室、自宅などです。Claude、Cursor、その他の MCP クライアントに接続して、次のように尋ねるだけです。

「今、冷凍庫の温度は何度？」 「今日、ウォークイン冷蔵庫が 40°F を超えた？」 「オフライン、またはバッテリー残量が少ないセンサーはある？」

サーバーは Temp Stick 公式 API からのリアルタイムデータで回答します。温度（摂氏と華氏）、湿度、バッテリー残量、オフライン状態、アラートの定義、最近の測定値の概要を取得できます。

• 依存関係ゼロ。 Python 3 の標準ライブラリのみを使用しているため、pip install は不要です。クローンしてキーを追加すれば、すぐに使えます。
• 読み取り専用。 アカウントの設定、しきい値、アラートを変更することはできません。
• プライバシーを重視した設計。 API キーは環境変数としてお使いのマシン上に保存されます。サーバーが通信するのは tempstickapi.com のみです。

ツール

ツール	返される内容
list_sensors	キーで参照できるすべてのセンサーと、最新の温度、湿度、バッテリー残量、オフライン状態。
get_sensor	1 台のセンサー（sensor_id で指定）の最新の測定値。
get_freezer_status	センサーを 1 回の呼び出しで確認します。最新の測定値、最近の履歴の概要、アラートの定義をまとめて取得します。代表的な冷凍庫の用途にちなんだ名前ですが、どのセンサーにも使えます。
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 では、python3 の代わりに python を使用し、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 のいくつかの動作について説明します。

• エラーは JSON エンベロープ（type: "error"）を伴う HTTP 200 として返されます。そのため、サーバーはエンベロープを確認し、Invalid X-API-KEY などの実際のメッセージを表示します。
• 温度は摂氏で届きます。すべての測定値は華氏でも報告されます。
• API ホストはブラウザー以外のユーザーエージェントを拒否するため、サーバーはブラウザーのユーザーエージェントを送信します。

ステータス

公式 Temp Stick API に基づいて構築されたコミュニティプロジェクトです。Ideal Sciences または Temp Stick とは提携しておらず、承認も受けていません。解析層とプロトコル層はオフラインのフィクスチャテストで検証されています（selftest.py を参照）。ドキュメントに記載されたフィールド以外の測定値やアラートの形式も、堅牢に解析されます。

OpenPandora が開発

OpenPandora が開発しました。独立系レストラン向けの AI ツールです。パイロットキッチンのウォークイン冷凍庫を監視しているものと同じセンサー監視ツールを、Temp Stick を使うすべての事業者が AI に質問できるよう、無料で公開しました。

ライセンス

MIT — LICENSE をご覧ください。