FindSaunaPlunge — US cold plunge & sauna studios

FindSaunaPlunge MCP サーバー

findsaunaplunge.com 向けの Model Context Protocol サーバーです。米国の大都市圏にあるコールドプランジ、サウナ、交代浴施設を扱います。get_data_freshness は、現在の施設数と各レコードの最終確認日を返します。公開されている温度と料金はすべて施設自身のページから取得され、出典 URL、取得日、引用文がそのまま記録されています。フィールドが存在しない場合、その詳細は施設が公開していないことを意味します。ゼロを意味するものではありません。

• エンドポイント： https://findsaunaplunge.com/mcp — Streamable HTTP、ステートレス、認証不要、CORS オープン。GET は人間向けのドキュメントを返し、POST は JSON-RPC を受け付けます。
• レジストリ： com.findsaunaplunge/findsaunaplunge（ドメイン検証済み）。
• データ： CC BY 4.0 フィード /api/v1/venues.json と同じレコードです。github.com/findsaunaplunge/data で毎月アーカイブされ、DOI は 10.5281/zenodo.22132913 です。

ツール

ツール	引数	戻り値
search_venues	query?、citySlug?、modality?、access?、maxDropInUsd?、limit?	簡潔な施設レコード。フィルターは AND 条件で組み合わされます。maxDropInUsd に一致するのは、ドロップイン料金が公開されている施設のみです。
get_venue	id	sources を含む、フィードの完全なレコード。
list_cities	—	対象都市と、施設数および利用可能なモダリティ。
get_city_stats	citySlug	施設数、公開されている料金と温度の範囲、交代浴に対応する施設。
get_data_freshness	—	フィードの生成日時と、最新／最古の lastVerified。

接続

# Claude Code
claude mcp add --transport http findsaunaplunge https://findsaunaplunge.com/mcp

# Any client, by hand
curl -s -X POST https://findsaunaplunge.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_venues","arguments":{"citySlug":"austin-tx","modality":"cold_plunge","limit":3}}}'

自分で実行する

ハンドラーに必要なのは公開フィードのみなので、Node 24 以降が動作する環境であればどこでも実行できます。

npm start                    # JSON-RPC over stdio, one message per line (= node src/serve.ts --stdio)
npm run http                 # Streamable HTTP on :8080 — POST /mcp        (= node src/serve.ts)
docker build -t findsaunaplunge-mcp . && docker run -i findsaunaplunge-mcp   # stdio
npm test                     # smoke test: stdio + HTTP against the live feed

どちらのモードも https://findsaunaplunge.com/api/v1/venues.json を読み込みます（FINDSAUNAPLUNGE_ORIGIN で変更できます）。そのため、セルフホストしたコピーもサイトとまったく同じ内容を提供します。

動作の仕組み

src/mcp.ts がサーバー全体を構成しています。これは、サイトの Cloudflare Worker 内で /mcp にマウントされる単一の handleMcp(request, env) 関数です。依存関係はありません。ツールの結果は、サイトのビルドで生成される静的な /api/v1/venues.json アセットから取得します（Worker の ASSETS バインディング経由で取得し、アイソレートごとにメモ化されます）。そのため、サーバーの内容がサイトと食い違うことはなく、デプロイ時に自動で更新されます。server.json はレジストリマニフェストです。

このリポジトリは、そのサーバーの公開ソースです。サイト自体はオープンソースではありません。

設計ルール

• ステートレスです。セッションやサーバーから開始する SSE はありません。各 POST は単独で完結します。
• 不明な引数は黙って無視せず、有効な引数を示すメッセージとともに拒否されます。
• ここに有料掲載はなく、今後も行いません。

ライセンス

MIT — LICENSE を参照してください。サーバーが提供する施設データには、別途 CC BY 4.0 ライセンスが適用されます。