mcpField
M
mcp-contractor-license-lookup

mcp-contractor-license-lookup

本地服务
github.com/mambalabsdev法律与政务0今天更新

关于 mcp-contractor-license-lookup

面向查询五个州公共牌照记录的 MCP 服务,支持按行业和地点列出承包商,也可按牌照号或企业名称核验;任务通过 Apify 执行。

主要功能

  1. 01按行业和地点列出持牌承包商
  2. 02按牌照号或企业名称核验
  3. 03返回状态、到期日、分类和联系方式
  4. 04支持 CA、TX、WA、OR 和 LA

适用场景

  1. 01建立某县的屋顶承包商名单
  2. 02核验承包商的牌照状态
  3. 03查找 HVAC 承包商及联系方式

MCP 相关

向 MCP 客户端提供 `lookup_contractor_licenses` 工具。它启动 Apify Actor、等待运行完成并返回数据集行。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"com-mambabuilt-mcp-contractor-license-lookup": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-contractor-license-lookup"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
启动命令npx -y @mambalabsdev/mcp-contractor-license-lookup
需要配置的环境变量
APIFY_TOKEN密钥Apify API token from https://console.apify.com/account/integrations

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@mambalabsdev/mcp-contractor-license-lookup1.0.0

工具

1

收录的工具列表 · 更新于 4 天前

参数类型必填说明
modeenum否list(默认):输入州和行业,输出持证承包商。lookup:输入许可证编号或企业名称,输出其许可证。list | lookup
citiesarray否列表模式。仅保留这些城市中的承包商;每个城市会单独搜索。
countystring否列表模式。仅保留该县的承包商(CA、TX 和 OR 记录县信息)。
statesarray否州代码:CA、TX、WA、OR、LA。在 lookup 模式下,用于未注明州的行。
tradesarray否列表模式。行业名称,例如 plumbing、electrical、hvac、roofing、general、solar、landscaping、painting、concrete 或 pool。
lookupsarray否查询模式。每行一项:州代码、竖线、许可证编号或企业名称,例如 WA | 04CONCL862CR 或 LA | Acadian Builders。
proxy_modeenum否auto 使用 Apify 代理,并将被拒绝的请求转至住宅地址;residential 仅使用住宅代理。这是可靠性选项;使用代理不会增加费用。默认值为 auto。auto | residential
active_onlyenum否仅保留有效且未过期的许可证。默认值为 true。true | false
max_resultsstring否每次搜索返回的许可证行数,最多 5000 条。每条许可证行都会计费。列表模式下默认值为 100,查询模式下为 10。
business_namestring否列表模式:仅保留包含此文本的名称。查询模式:再查询一个企业名称。
include_ownersenum否华盛顿州:读取每个许可证当前的负责人。默认值为 true。true | false
license_numberstring否查询模式。在 states 中搜索另一个许可证编号。
max_charge_usdstring否可选。若任何一行会使费用超过此金额,则在返回该行前停止运行。

详细介绍

承包商执照查询 MCP 服务

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

这是一个适用于 Apify 上 Mamba Labs 承包商执照查询 Actor 的 MCP 服务。提供州和行业类别,即可列出持证承包商;提供执照号码或企业名称,即可核验执照。每次运行都会读取州执照委员会自己的公开登记册。

内容

功能

有两种模式:

  • list:提供 states 和 trades(例如 CA 和 roofing),还可选提供 cities 或 county。每位持证承包商会占一行,包含执照号码、状态、到期日期、分类、所有者或资格负责人、地址和电话。
  • lookup:提供 lookups,每行一个,例如 WA | 04CONCL862CR 或 LA | Acadian Builders。系统会返回匹配的执照及其状态。

覆盖的州:加利福尼亚州(CSLB Data Portal 列表)、得克萨斯州(TDLR 开放数据)、华盛顿州(Labor and Industries 开放数据)、俄勒冈州(CCB 开放数据)和路易斯安那州(LSLBC 公共查询)。由于 CSLB 执照核验页面使用 reCAPTCHA,加利福尼亚州的名称和号码查询仅支持在行业列表中进行。每次搜索结束时都会附带一条免费的摘要行。所有工作都在 Apify 上运行。此软件包是一个轻量级客户端,用于启动 Actor 运行、等待运行完成,并返回数据集行。

快速开始

你需要 Node.js 18 或更高版本,以及一个带有 API 令牌的 Apify 账户。

将以下内容添加到 Claude Desktop 配置文件(claude_desktop_config.json)、Cursor 或任何 MCP 客户端中:

{
  "mcpServers": {
    "mamba-contractor-license-lookup": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-contractor-license-lookup"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端。随后即可看到 lookup_contractor_licenses 工具。

先决条件

  • Node.js 18 或更高版本。
  • 从 console.apify.com/account/integrations 获取 Apify API 令牌,并将其设为 APIFY_TOKEN。服务无需令牌即可列出工具;调用工具时则需要令牌。

提示词示例

  • “列出加利福尼亚州圣迭戈县持证的屋顶承包商。”
  • “华盛顿州承包商执照 04CONCL862CR 是否有效?主要负责人有哪些?”
  • “查找得克萨斯州奥斯汀持证的暖通空调承包商及其电话号码。”

工具

lookup_contractor_licenses。仅有一个工具。参数示例:

{
  "mode": "list",
  "states": ["CA"],
  "trades": ["roofing"],
  "county": "San Diego",
  "max_results": "100"
}

输入项

该 Actor 面向买家的所有输入项,均保持不变。省略的输入项将使用 Actor 自身的默认值。数字和布尔值均以字符串形式发送。

输入项类型描述
modestringlist(默认)或 lookup
statesarrayCA、TX、WA、OR、LA
tradesarraylist 模式。行业关键词
citiesarraylist 模式。城市,分别搜索
countystringlist 模式。县(CA、TX、OR)
business_namestringlist 模式:名称筛选。lookup 模式:额外的一个名称
lookupsarraylookup 模式。类似 WA | 04CONCL862CR 的条目
license_numberstringlookup 模式。额外的一个许可证编号
active_onlystringtrue 或 false。默认 true
include_ownersstring华盛顿州负责人。默认 true
max_resultsstring每次搜索的行数,上限为 5000
max_charge_usdstring可选的本次运行费用上限
proxy_modestringauto 或 residential。默认 auto

定价

在 Apify 上按事件付费,费用计入你的 Apify 账户。价格以美元计。

事件免费计划BronzeSilverGold
license-row,每条返回的许可证$0.004$0.0038$0.0036$0.0034
apify-actor-start,每次运行启动$0.0005$0.0005$0.0005$0.0005

搜索汇总行,以及跳过、受阻和无结果的行,均免费。

你的密钥

该 Actor 无需密钥。它会读取各州委员会的公开登记信息,且不持有任何密钥。代理流量不会增加费用:Mamba Labs 支付本次运行的平台成本。proxy_mode 是一项可靠性设置。

Actor 完整文档

apify.com/mambalabs/contractor-license-lookup

许可证

MIT。参见 LICENSE。

评论

支持 Markdown

第一次接触 MCP?

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

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