Census Geocoder

@pipeworx/census-geocoder

美国人口普查局自己的地理编码器：将美国街道地址转换为 TIGER/Line 坐标，以及该点的完整人口普查地理信息层级——州、县、人口普查区、人口普查街区、居民点、国会选区、学区和 CBSA，每一项都附有 GEOID。

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

工具

• census_geocode_address(address | street/city/state/zip, benchmark?, vintage?) — 对单个地址进行正向地理编码；返回坐标和地理信息层级。
• census_reverse_geocode(latitude, longitude, benchmark?, vintage?) — 包含某个坐标的所有 人口普查地理区域。
• census_geocode_batch(addresses[], benchmark?, vintage?) — 单次调用最多处理 100 个 地址；逐行返回匹配状态、标准化地址、坐标以及州／县／人口普查区／街区 FIPS，并附上组合后的 人口普查区和街区 GEOID。

身份验证

无需密钥。

数据源

• https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress — 单行地址正向地理编码。
• https://geocoding.geo.census.gov/geocoder/geographies/address — 结构化地址正向地理编码。
• https://geocoding.geo.census.gov/geocoder/geographies/coordinates — 反向地理编码。
• https://geocoding.geo.census.gov/geocoder/geographies/addressbatch — 多部分 CSV 批量处理。

相关工具包：census-tigerweb 描述地理区域本身（例如列出某县的所有人口普查区）；本工具包回答“这个地址位于哪个人口普查区”。 geocodio 工具包是商业地理编码器，若结果必须是人口普查 GEOID，则不能用它替代。

注意事项

• benchmark 和 vintage 必须匹配。Public_AR_Current 应与 Current_Current 配对；如果配对不匹配，会返回 400 错误，且响应正文没有提供有用信息。
• /geographies/* 端点返回地理区域；/locations/* 端点只返回坐标。本工具包始终使用 /geographies。
• 批量端点使用多部分 CSV POST 请求，并以 CSV 格式返回结果，而且会对收到的每一行都进行地理编码。发送表头行会得到一条针对字面文本“street”的 No_Match 结果。本工具包不会发送表头行。
• 批量处理的列按位置排列（id,street,city,state,zip），因此街道字段中未加引号的逗号会导致后续所有列错位。每个单元格都带引号。
• 国会和州立法层名称包含届次编号，因此通过模式匹配，而不是匹配会过期的名称。

快速开始

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

{
  "mcpServers": {
    "census-geocoder": {
      "url": "https://gateway.pipeworx.io/census-geocoder/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/census-geocoder/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 都会访问同一个网关和相同的 1875+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；通过任一端点，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/census_geocode_address \
  -H 'Content-Type: application/json' \
  -d '{"address":"1600 Pennsylvania Ave NW, Washington, DC 20500"}'

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/census_geocode_address。查找工具：POST https://gateway.pipeworx.io/v1/tools/search_packs，并提供 {"query":"..."}。

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

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

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

或者直接运行，以确认它能够启动：

npx -y @pipeworx/mcp-census-geocoder

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅支持此软件包的工具，不包含上方网关连接额外提供的共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以不用直接调用工具，而是用简单的英语提问——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Census Geocoder data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT