The Septic Guide

The Septic Guide MCP 服务

适用于 thesepticguide.com 的只读 Model Context Protocol 服务。该网站是美国化粪池承包商目录，依据已公布的州许可证和认证记录编制。

无需 API 密钥。不会写入数据。每条结果都包含 thesepticguide.com 上的 source_url。

工具

工具	返回内容
list_states	提供许可页面和／或公司目录的州，并附链接
get_state_licensing	state（名称或代码）：负责化粪池相关工作的许可机构、其官方查询 URL、页面日期，以及页面上的许可问答
search_septic_companies	state，以及可选的 city、county、zip、service、licensed_only、limit：企业列表，包含许可证编号、机构验证链接、电话、网站和个人资料链接
get_cost_guide	可选的 topic（例如 pumping、drain field）：简短回答、费用表，以及页面引用的第三方来源。不指定主题时会列出所有主题

数据

默认情况下，服务从 data/ 中的捆绑快照读取数据（索引、许可和费用页面位于 data/snapshot.json，每个州的公司数据则位于 data/companies/ 中的一个压缩文件内）。每条响应都包含 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/，也会自动使用实时模式。

公司数量

每个州页面的元描述都会给出一个醒目的数量（例如，Texas：“363 家化粪池公司”）。部分州的州页面与县页面上实际显示的列表总数较少（Texas：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。版权所有 (c) 2026 Catalyst Digital Services LLC。