mcpField
S
stoop

stoop

远程服务
github.com/oliverhpage商业与营销031 周前更新
代码仓库

关于 stoop

stoop 是面向迈阿密地区居民的 MCP 服务,可查找持牌的暖通空调、管道和电气服务商。它依据执照、评分、距离、紧急程度和预算排序,并提供联系方式与价格信息。

主要功能

  1. 01搜索暖通空调、管道和电气服务商
  2. 02通过 DBPR 核验佛州执照
  3. 03按评分、距离、紧急程度和预算排序
  4. 04查看服务商详情与联系方式
  5. 05保存房屋资料和搜索记录

适用场景

  1. 01在迈阿密为漏水水龙头寻找管道工
  2. 02空调紧急故障时查找暖通服务商
  3. 03为配电箱升级比较电工

MCP 相关

向 MCP 客户端提供四种工具:service_search、provider_profile、home_profile 和 job_history。客户端可搜索服务商、查看资料、保存房屋信息并查询过往搜索与联系记录。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://stoop-mcp-server.stoop.workers.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

4
参数类型必填说明
querystring是用自然语言描述所需服务,例如 'AC not cooling' 或 'need a plumber for a leak'
urgencyenum否服务需求的紧急程度emergency | urgent | routine
categoryenum否明确指定行业类别(通常根据 query 推断)hvac | plumbing | electrical
locationstring否要搜索的地址或区域,例如 'Miami Beach, FL'。默认值为 Miami。
budget_maxnumber否服务的最高预算(美元)

详细介绍

Stoop — 通过 AI 助手查找持证承包商

Stoop 是一款 MCP 服务,可将 AI 对话转化为实际的承包商匹配结果。向 Claude 查询迈阿密的水管工、暖通空调技术人员或电工,即可立即获取 3 家持证且评分良好的服务商,以及他们的电话号码和价格。

不用再 Google 搜索。不用再打开 5 个标签页。不用再给陌生号码打电话。

工作原理

你可以向 Claude 提出这样的问题:

“我家厨房水龙头漏水了,需要在迈阿密找一位水管工”

Stoop 会根据执照状态、评分、距离和价格,为你筛选并排序 3 家经过核实的服务商,并提供直接拨打电话或发送短信的链接。

你将获得:

  • 已通过佛罗里达州 DBPR 数据库核实的持证服务商
  • 来自 Google Places + Yelp 的星级评分和评价数量
  • 针对你所需服务的价格范围
  • 支持一键拨打电话或发送短信的电话号码
  • 紧急情况识别(爆管和设备调试会返回不同结果)

快速设置(2 分钟)

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stoop": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://stoop-mcp-server.stoop.workers.dev/mcp"
      ]
    }
  }
}

重启 Claude Desktop。设置完成。

验证是否正常运行

向 Claude 提出以下任意问题:

  • “我需要在迈阿密找一位水管工”
  • “我的空调坏了,现在有 95 度”
  • “紧急!我家地下室的管道爆裂了”
  • “在 Coral Gables 附近找一位电工升级配电箱”

Stoop 搜索范围

工种覆盖数量执照类型
水管服务234 家服务商FL CFC License
电气服务230 家服务商FL EC License
暖通空调175 家服务商FL CAC License

所有服务商均位于迈阿密-戴德县和布劳沃德县都会区。数据来源包括 Google Places、Yelp Fusion 和佛罗里达州商业与职业监管部(DBPR)。

MCP 工具

Stoop 通过 Model Context Protocol 提供 4 个工具:

工具描述
service_search按工种、地点、紧急程度和预算搜索服务商
provider_profile获取特定服务商的详细信息(执照、营业时间、评价)
home_profile保存你的房屋信息,以改善后续匹配结果
job_history查看你过去的搜索和联系记录

排名方式

服务商按 100 分制评分:

因素分值说明
有效的 FL 执照30已通过 DBPR 核实
星级评分0–20根据 Google/Yelp 评分换算
评价数量0–15按对数刻度计算,上限约为 150 条评价
距离0–15每近 1 英里加 1 分
可用性10v1 中假定服务商有空
价格匹配度10符合你的预算
紧急情况加分+15仅适用于紧急请求

技术栈

  • 运行时: Cloudflare Workers(全球边缘网络)
  • 数据库: Supabase PostgreSQL + PostGIS
  • 意图解析: 优先使用关键词,必要时由 Claude Sonnet 兜底
  • 数据来源: Google Places API、Yelp Fusion API、FL DBPR
  • UI 组件: React 19 MCP App 卡片,不支持时回退为文本/Markdown
  • Monorepo: 使用 Turborepo 管理共享 TypeScript 软件包

当前覆盖范围

目前仅覆盖迈阿密都会区(迈阿密-戴德县 + 布劳沃德县),包括 3 个工种:暖通空调、水管服务和电气服务。

未来将根据需求拓展到更多城市和工种。

隐私

  • 你的搜索查询会被保存用于分析(以改进结果)
  • 不会向大模型发送个人信息,只会发送查询文本
  • 服务商数据来自公开来源(Google、Yelp 和州执照数据库)
  • 你可以随时申请删除数据

贡献

这是一个早期产品。欢迎通过 github.com/oliverhpage/stoop/issues 提交问题和反馈。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。