关于 Md Dmv
Md Dmv 是用于查询马里兰州车辆注册量及纯电动、插电式混合动力汽车普及情况的 MCP 服务,按县或 ZIP 代码提供月度数据。它面向分析人员等数据使用者,并提供全州总量及兼容不同县名拼写的匹配。
主要功能
- 01按县查询月度车辆数量
- 02按县或 ZIP 查询电动及插混车辆
- 03提供全州总量和县级占比
- 04兼容标点不同的县名
适用场景
- 01比较马里兰州各县车辆注册量
- 02查询某县或 ZIP 的插电车辆数量
- 03查看月度全州车辆注册总量
MCP 相关
向 MCP 客户端提供车辆注册和电动汽车普及查询工具。可通过 Pipeworx 网关使用,也可作为独立的 stdio MCP 服务运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/md-dmv/mcpclaude mcp add --transport http pipeworx-io-md-dmv https://gateway.pipeworx.io/md-dmv/mcp{"mcpServers":{"pipeworx-io-md-dmv":{"type":"http","url":"https://gateway.pipeworx.io/md-dmv/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-md-dmv":{"type":"http","url":"https://gateway.pipeworx.io/md-dmv/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-md-dmv":{"type":"http","url":"https://gateway.pipeworx.io/md-dmv/mcp"}}}{"mcpServers":{"pipeworx-io-md-dmv":{"serverUrl":"https://gateway.pipeworx.io/md-dmv/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
@pipeworx/md-dmv
马里兰州 DMV MCP——来自马里兰州机动车管理局(MVA)的按县和 ZIP 代码统计的月度注册车辆数量,以及电动汽车/插电式混合动力汽车的普及情况。
属于 Pipeworx——一个将 AI Agent 连接到 1679+ 个实时数据源的 MCP 网关。
工具
md_dmv_vehicle_registrations(county?, month?, limit?)— 按县统计某个月的注册车辆数量,并提供真实的全州总数及各县所占比例。可回答“马里兰州蒙哥马利县注册了多少辆车”“马里兰州哪个县注册车辆最多”“马里兰州注册了多少辆汽车”。md_dmv_ev_adoption(county?, zip?, month?, group_by?, limit?)— 按县或 ZIP 代码统计某个月的纯电动汽车和插电式混合动力汽车注册数量,并提供马里兰州总数作为参考。可回答“马里兰州蒙哥马利县注册了多少辆电动汽车”“ZIP 代码 20852 的电动汽车注册数量”“马里兰州哪些 ZIP 代码的电动汽车最多”。
身份验证
无需密钥。
数据源
- https://opendata.maryland.gov/resource/db8v-9ewn.json — MDOT MVA 按月统计的各县注册车辆数据。字段:
year_month(“2026/06”)、county、vehicle_count。每月 25 行(23 个县、巴尔的摩市,以及一个无法确定注册归属的NULL类别)。 - https://opendata.maryland.gov/resource/qtcv-n3tc.json — MDOT MVA 按月统计的各县纯电动汽车和插电式混合动力汽车注册数据。字段:
year_month、fuel_category(“Electric” | “Plug-In Hybrid”)、county、count。每月约 464 行。 - https://opendata.maryland.gov/resource/tugr-unu9.json — 相同数据,按 ZIP 代码统计。字段:
year_month、fuel_category、zip_code、count。每月约 2,065 行。
这三个数据源均按月更新,时间范围为 2020/07 至 2026/06(截至 2026-07-29 的最新数据)。
注意事项:马里兰州 WAF 会拒绝特定的查询 形式,而非查询本身
opendata.maryland.gov 位于 Cloudflare WAF 之后,某些 SoQL 查询形式会触发“Just a moment...”中间页——HTTP 403,响应正文为 HTML——而非返回数据。这个问题可以复现,且仅出现在这一个域名:data.ny.gov、data.wa.gov 和 data.ct.gov 都会正常接受完全相同的子句。最初是在已部署的 Cloudflare Worker 上遇到此问题,后来也在笔记本电脑上复现了,因此这是请求本身的特性,与调用方 IP 无关。
已确认会触发问题的形式:
| 形式 | 示例 |
|---|---|
任意 like '%x%' 通配符子句 | $where=upper(county) like '%MONTGOMERY%' |
包含两个以 AND 连接条件的 $where | $where=year_month='2026/06' AND county='MONTGOMERY' |
包含两个聚合表达式的 $select | $select=min(year_month) as mn, max(year_month) as mx |
已确认可正常使用的形式:
| 形式 | 示例 |
|---|---|
单个 year_month 相等条件 | $where=year_month='2026/06' |
包含一个聚合表达式的 $select | $select=max(year_month) as mx |
因此,此工具包只发送一个条件,获取整个月的数据(最多约 2,100 行),并在代码中完成县/ZIP 代码筛选、聚合和排序。这样开销很低,而且能让工具包返回数据,而不是 HTML 验证页面。不要将筛选“优化”回服务器端。
还有一个好处:由于始终会获取完整月份的数据,statewide_total_vehicles 和 maryland_plug_in_vehicles 提供的是真实总数,而不是对经过 limit 筛选的数据求和。返回行的总和会单独报告为 sum_of_returned_rows。
注意事项:同一个县的拼写有两种形式
车辆注册数据与电动汽车数据对同一地点的标点使用方式不一致:
| 地点 | db8v-9ewn(注册数据) | qtcv-n3tc / tugr-unu9(电动汽车数据) |
|---|---|---|
| 普林斯乔治县 | PRINCE GEORGE'S | PRINCE GEORGES |
| 圣玛丽县 | ST. MARY'S | ST MARYS |
| 安妮女王县 | QUEEN ANNE'S | QUEEN ANNES |
两个工具在匹配前都会忽略标点,因此调用方可以使用任意一种拼写。
注意:EV 文件包含州外县
马里兰州会记录注册人的居住县(或 ZIP),因此 qtcv-n3tc 中包含约 300 个数量较少的非马里兰州县——ADAMS、ALAMEDA、ALBEMARLE 等——与马里兰州的 24 个辖区混在一起。每个县行都标记为 in_maryland,而 maryland_plug_in_vehicles 只统计马里兰州的县。
最棘手的情况:弗吉尼亚州的 PRINCE GEORGE 紧挨着马里兰州的
PRINCE GEORGES,而弗吉尼亚州的名称与短语“Prince George”完全匹配。因此,县解析器会返回两行(并标明标记),而不会悄悄选中只有 1 辆车的弗吉尼亚州县,而忽略拥有 17,899 辆车的马里兰州县。
已核实的数据(2026/06,核实于 2026-07-29)
| 查询 | 结果 |
|---|---|
md_dmv_vehicle_registrations{county:"Montgomery"} | 804,525 辆车 |
md_dmv_vehicle_registrations{} | 全州共 5,190,640 辆 |
md_dmv_ev_adoption{county:"Montgomery"} | 36,477 辆纯电动车 + 12,319 辆插电式混合动力车 |
md_dmv_ev_adoption{zip:"20852"} | 1,660 辆纯电动车 + 566 辆插电式混合动力车 |
md_dmv_ev_adoption{} | 马里兰州共 153,463 辆插电式车辆 |
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"md-dmv": {
"url": "https://gateway.pipeworx.io/md-dmv/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/md-dmv/mcp 上的 tools/list 会返回上表中的工具,以及 Pipeworx 共享元工具——ask_pipeworx、
discover_tools、search_within、remember/recall 和网关全局工具集中的其他工具。因此,你看到的工具数量会多于此表所列:目前,单个数据包端点会在该数据包自身的工具之外,列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围,是当天情况的权威信息。
这是有意为之,并非意外的多路复用。元工具能让限定范围的连接通过 ask_pipeworx 跨整个目录路由,从而回答此数据包未涵盖的问题,而无需添加第二个 MCP 服务。目前无法挂载不包含这些工具的数据包端点;如果额外的架构占用的上下文超过路由带来的价值,请连接一次完整网关,而不是连接多个数据包端点。
也可以连接完整的 Pipeworx 网关,直接列出所有数据包的工具,而不只是此数据包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
两个 URL 都连接到同一个网关和相同的 1679+ 个数据源。唯一的区别是直接列出哪个数据包的工具;无论连接哪个端点,ask_pipeworx 都可以访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/md_dmv_vehicle_registrations \
-H 'Content-Type: application/json' \
-d '{"county":"Montgomery","month":"2026/06"}'
首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/md_dmv_vehicle_registrations。查找工具:使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。
独立运行(无需网关账户)
此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户,也无需经由网关往返:
{
"mcpServers": {
"md-dmv": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-md-dmv"]
}
}
}
或者直接运行,确认服务可以启动:
npx -y @pipeworx/mcp-md-dmv
它通过 stdin/stdout 使用 MCP 通信,并针对仅此数据包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接额外提供的任何共享元工具。数据源相同,工具相同,但没有 ask_pipeworx 路由。
使用 ask_pipeworx
你也可以用自然语言提问,而不是直接调用工具——此方式既适用于上文的数据包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Md Dmv data" })
网关会自动选择合适的工具并填入参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。