Hpms Aadt

@pipeworx/hpms-aadt

按州和数据年份提供美国各道路路段的道路交通量（AADT，即年平均日交通量），数据来自联邦公路管理局的公路性能监测系统。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1863+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也非其发布。

工具

• aadt_near_point(lat, lon, state, radius_m?, year?, limit?) - 查询指定点一定半径内的道路路段，按交通量从高到低排序。
• aadt_by_route(state, route, county?, min_aadt?, year?, limit?) - 查询 route_id 以指定前缀开头的路段，例如「I089」（佛蒙特州）、「IH0035」（德克萨斯州）、「SHS_101」（加利福尼亚州）。
• aadt_top_segments(state, county?, f_system?, year?, limit?) - 查询某州交通量最高的路段，可按县或道路功能等级筛选（1 为州际公路，7 为地方道路）。同时显示该州 route_id 的命名格式。
• aadt_layers(state) - 查询某州有哪些数据年份，以及每个年份包含哪些列。

每个响应都包含 data_year、data_as_of、source、注意事项、total_matching、returned 和 truncated。如果查询没有匹配到任何报告了 AADT 的路段，则会返回缩小查询范围的提示，而不是空列表。

身份验证

无需密钥。

数据源

• FHWA（美国交通部），公路性能监测系统（HPMS）——公开发布的州级数据集，每个州和数据年份各一份（50 个州、DC、PR；几乎所有州都有 2020 年和 2022-2025 年的数据）。美国联邦数据，属于公有领域。每次请求都会实时查询；不会复制数据。

注意事项

• AADT 是州向 FHWA 报告的道路路段数值，部分通过抽样并扩算得出。它不是原始计数器读数，数据行代表路段（起点和终点里程标），而非计数站点。
• route_id 是各州自定义的自由文本字段。没有全国通用的路线标识，因此「跨州查询 I-95」无法通过单次查询完成。一条公路在同一州可能有多个标识（例如主线和辅道）。
• state 为必填项：县代码和路线标识仅在州范围内有意义，并且此数据包不会根据地点推测州。
• 最新的数据年份不再包含路线编号和路线名称列，且有一个州不再包含路段长度。此数据包会读取每年的列清单，并且只请求实际存在的列，因为向上游请求缺失的列会导致硬错误。
• 许多路段没有报告 AADT；每次查询都会筛选出有报告值的路段。不进行此筛选就排序，会导致空值排在前面。
• 在大型州，冷启动时计算行数可能较慢，因此 total_matching 仅为尽力计算；如果未能及时返回，该值会是 null，而 truncated 则根据页面大小推断。
• 可能会出现看起来重复的行（同一路段被报告多次）；这些行会按发布内容原样返回。

快速开始

添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "hpms-aadt": {
      "url": "https://gateway.pipeworx.io/hpms-aadt/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/hpms-aadt/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 都指向同一网关和相同的 1863+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/aadt_near_point \
  -H 'Content-Type: application/json' \
  -d '{"lat":34.0522,"lon":-118.2437,"state":"CA","radius_m":1000,"limit":5}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/aadt_near_point。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

从 npm 运行

@pipeworx/mcp-hpms-aadt 是连接到 Pipeworx 网关的本地 stdio 桥接程序：你的 MCP 客户端会通过 npx 启动它，然后由它将每次调用转发到上面所示的同一个 https://gateway.pipeworx.io/hpms-aadt/mcp 端点。它需要网络连接；没有离线模式。

{
  "mcpServers": {
    "hpms-aadt": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hpms-aadt"]
    }
  }
}

不提供密钥时，它会以匿名方式调用，每天最多 50 次。免费账户可将限额提高到每天 200 次：在 https://pipeworx.io/signup 获取密钥，并将 "env": { "PIPEWORX_API_KEY": "<your key>" } 添加到服务条目中。 密钥会以 Bearer 令牌的形式发送，与托管连接发送密钥的方式相同，因此调用会按原样计量和计费。

默认情况下，它只列出此工具包的工具。设置 PIPEWORX_META_TOOLS=1，也会列出 ask_pipeworx 和其他全网关工具。

通过 HTTPS 代理连接时：Node 内置的 fetch 默认不会读取 HTTPS_PROXY。较新版本的 Node 在设置 NODE_USE_ENV_PROXY=1 后会使用该变量；请查阅你的 Node 版本文档。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Hpms Aadt data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT