Dc Dmv

@pipeworx/dc-dmv

哥伦比亚特区 DMV 数据：服务中心、记录级别的车辆检验文件和交通违规定罪。无需密钥。

属于 Pipeworx 项目——一个将 AI Agent 连接到 1679+ 个实时数据源的 MCP 网关。

为什么 DC 有自己的数据包

DC 的数据粒度与任何州都不同。特区发布了 766,879 条车辆检验记录（以 VIN 为键）和 330,728 条交通违规定罪记录（以传票为键），两者都是 DCGIS 服务器上的 ArcGIS 表——而不是大多数州发布的县级汇总数据。因此，这些工具使用 VIN、违规文本和日期范围作为参数，而不是县名。

工具

工具	返回内容
dc_dmv_offices	全部 9 个 DMV 地点——服务中心、检验站、两个自助排放检测亭、Deanwood 路考/CDL 中心，以及裁决服务处
dc_dmv_vehicle_inspections	按 VIN 或 VIN 前缀查询检验记录及检验和到期日期；或查询每月/每年的检验数量
dc_dmv_convictions	按违规行为或法院裁决统计交通违规定罪数量，或查询单条传票记录

身份验证

无需身份验证。所有上游数据均来自公开的 DCGIS ArcGIS MapServer 图层。

State Plane 坐标陷阱

办公地点图层的 XCOORD/YCOORD 列使用的是马里兰州平面坐标系的米制坐标，而不是经纬度。 Georgetown 服务中心的坐标显示为 394380.55, 137456.23——数字看起来合理，但若将其视为坐标，位置会偏出半个地球。

这里的每个查询都会向 arcgisQuery 传入 geometry: true（它会设置 outSR=4326），并从返回的几何信息中读取纬度和经度。响应中会有意省略 XCOORD/YCOORD，以免下游将其误认为坐标。Georgetown 的实际位置是 38.9050, -77.0648。

值得了解的注意事项

以下均为实时验证过的行为，并非猜测：

• 检验文件中的 STATUS 列在全部 766,879 条记录中均为空，因此没有发布通过/未通过结果。你能查到的是检验是否发生、检验时间，以及检验证书的到期时间——证书约两年后到期通常表示检验通过，较短的有效期则表示需要在期限内复检。工具的 note 会说明这一点，避免调用方将空值理解为“结果未知”。如需查看包含品牌和车型的逐项检验通过/未通过结果，可使用 nj_mvc_vehicle_inspections。
• 检验表中的 GIS_ID、CREATOR 和 CREATED 也均为空。
• 约一半的违规定罪记录会在违规文本前加上四位内部代码——0201SPEED IN EXCESS OF LIMIT 和 SPEED IN EXCESS OF LIMIT 属于同一违规行为，却被分在两个类别中。因此，直接分组统计会拆分每项违规行为并导致排名出错。该工具会去掉前缀并合并记录：“DISOBEYING OFFICIAL SIGN OR SIGNAL DEVICE”有 20,113 条定罪记录，而不是简单查询得出的 10,369 条。
• **DCGIS 对任何单次响应均设有 2,000 条记录的上限，包括分组统计。**按月和按年的汇总会先在上游按天分组（整个文件共有 1,874 个不同日期，未超过上限），再由代码汇总；如果哪次查询触及上限，响应会标记 truncated，并提示使用 inspected_since 缩小范围。
• **数据覆盖范围：**检验数据从 2020-11-01 到 2026-06-30，且仍在持续追加；违规定罪数据从 2002-07-01 到 2026-06-27。两者的覆盖范围都会通过 coverage 字段返回，而不是预先假定。
• **定罪记录就是定罪记录。**已撤销或尚未裁决的传票不在其中，因此这些统计数字并非罚单数量。
• 办公地点图层不包含邮政编码或营业时间。MATCHADDR 是特区自行地理编码的街道地址；各地点的营业时间请查阅 dmv.dc.gov。

可用但未封装

同一个 Transportation_DMV MapServer 还包含更多可查询但未作为工具公开的 DMV 表：

图层	表
142	DMV 商业信息
143	DMV 驾驶执照信息
144	DMV 身份证信息
145	DMV 互惠停车许可证
146	DMV 个性化车牌
147	DMV 残障停车牌
149	DMV 车辆检验 FY2003-2013
150	DMV 车辆检验 FY2014-2020
166	DMV 车辆锁车与拖车

图层 149 和 150 是历史检验档案，与当前表共用相同的架构，包括同样为空的 STATUS。

数据来源

• DCGIS Public_Service 图层 4 — 特区机构位置，筛选出 9 条 DMV 记录
• DCGIS Transportation_DMV 图层 1 — DMV 车辆检验
• DCGIS Transportation_DMV 图层 151 — DMV 定罪记录
• 数据集发现：opendata.dc.gov

快速开始

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

{
  "mcpServers": {
    "dc-dmv": {
      "url": "https://gateway.pipeworx.io/dc-dmv/mcp"
    }
  }
}

此端点实际提供的内容

对 https://gateway.pipeworx.io/dc-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/dc_dmv_offices \
  -H 'Content-Type: application/json' \
  -d '{"name":"Georgetown"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/dc_dmv_offices。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

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

也可以直接运行，确认服务能够启动：

npx -y @pipeworx/mcp-dc-dmv

它通过 stdin/stdout 使用 MCP 通信，并仅针对该工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接附带的共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Dc Dmv data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT