The Septic Guide

The Septic Guide MCP サーバー

thesepticguide.com 向けの読み取り専用Model Context Protocolサーバーです。thesepticguide.com は、公開されている州のライセンスおよび認定記録を基に構築された、米国の浄化槽施工業者ディレクトリです。

API キーは不要です。書き込みは行いません。すべての結果に thesepticguide.com の source_url が含まれます。

ツール

ツール	返される内容
list_states	ライセンス情報ページや業者ディレクトリがある州と、そのリンク
get_state_licensing	state（州名またはコード）：浄化槽工事のライセンスを発行する機関、公式の照会 URL、ページの日付、ライセンスに関するページの Q&A
search_septic_companies	state と、任意の city、county、zip、service、licensed_only、limit：ライセンス番号、機関の確認リンク、電話番号、ウェブサイト、プロフィールリンクを含む業者情報
get_cost_guide	任意の topic（例：pumping、drain field）：簡潔な回答、費用の表、ページで引用されている第三者の情報源。トピックを指定しない場合は、トピックの一覧

データ

デフォルトでは、サーバーは data/ 内のバンドル済みスナップショット（インデックス、ライセンス情報、費用ページ用の data/snapshot.json と、data/companies/ 内の州ごとの gzip 圧縮ファイル）を使って応答します。すべての応答には data_mode と data_as_of（スナップショットの日付）が含まれます。次のコマンドで再構築できます。

npm run snapshot   # crawls thesepticguide.com (sitemap, state + county pages) and rewrites data/

TSG_LIVE=1 を設定すると、スナップショットを使わずに thesepticguide.com からライブデータを読み込みます（メモリ内キャッシュは 6 時間）。data/ が存在しない場合も、自動的にライブモードが使われます。

業者数

各州ページのメタディスクリプションには、見出しとして業者数が記載されています（例：テキサス州：「浄化槽業者 363 社」）。州ページと郡ページに実際に表示されている業者数は、これより少ない州もあります（テキサス州では 360 社）。サーバーは結果を水増ししません。search_septic_companies は、検索した表示中の業者情報である listed_on_pages と、ページ独自の数である state_page_headline_count を返し、両者が異なる場合は count_note も返します。サービスやライセンス記録が異なる同名の業者情報は、州のリストでは別々の項目として保持されます。

データと制限事項

• 読み取り専用です。書き込みは行いません。API キーは不要で、ユーザーデータも収集しません。
• thesepticguide.com の公開データを使用します。すべての結果に thesepticguide.com の source_url が含まれます。
• ライセンスデータは、thesepticguide.com が照合した、州機関が公開するライセンスおよび認定の一覧に基づいています。契約前に、機関の verify_url でライセンスを確認してください。
• いずれの州機関とも提携していません。
• スナップショットのデータはライブサイトより古い場合があります。data_as_of を確認してください。

使用方法

リモート（Streamable HTTP）：https://mcp.thesepticguide.com/mcp

ローカル（stdio）：

git clone https://github.com/archer-clawbot/thesepticguide-mcp && cd thesepticguide-mcp && npm install && npm run build

{ "mcpServers": { "thesepticguide": { "command": "node", "args": ["/path/to/thesepticguide-mcp/dist/stdio.js"] } } }

Docker：docker build -t thesepticguide-mcp . && docker run -i --rm thesepticguide-mcp

開発：

npm install && npm run build
npm test                 # stdio smoke test with the MCP SDK client
npm test -- http         # same against MCP_URL (default http://localhost:3000/mcp)
npm run start:http       # http://localhost:3000/mcp

Vercel へのデプロイ：api/mcp.ts + vercel.json（/mcp を関数に書き換えます）。

ライセンス

MIT。Copyright (c) 2026 Catalyst Digital Services LLC.