mcpField
A
Address to Census Tract MCP

Address to Census Tract MCP

远程服务
github.com/theluckystrike其他01 天前更新
代码仓库

关于 Address to Census Tract MCP

Address to Census Tract MCP 让 AI 助手通过街道地址或坐标查询美国人口普查地理信息,数据来自美国人口普查局地理编码器。它还可解析 GEOID,并支持当前或指定年份的地理区划,无需 API 密钥。

主要功能

  1. 01按美国地址查询地理信息
  2. 02按坐标查询地理信息
  3. 03返回普查区、区块及选区标识
  4. 04离线解析 GEOID 组成
  5. 05选择普查年份版本

适用场景

  1. 01查询地址对应的普查区和 GEOID
  2. 02确定坐标对应的各级选区
  3. 03将 GEOID 拆解为 FIPS 部分

MCP 相关

向 MCP 客户端提供地址和坐标查询工具,以及离线 GEOID 解析工具。托管端点使用 HTTP;README 还介绍了计划中的本地 stdio 选项。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

address-to-census-tract-mcp

为 AI 助手提供地址到人口普查区的查询。输入美国街道地址或经纬度,即可从美国人口普查局地理编码器获取精确的人口普查区、街区组、街区、县 FIPS 代码和选区。

这是一个模型上下文协议(MCP)服务。它会在调用时查询人口普查地理编码器。无需 API 密钥。

工具

工具返回内容
get_census_tract_for_address匹配的地址、纬度和经度、11 位人口普查区 GEOID 和区号、街区组和街区 GEOID、州和县 FIPS 代码、建制市镇、县下辖行政区、国会选区、州参议院和众议院选区、城市区域及联合统计区域。
get_census_tract_for_coordinates对应纬度和经度的相同地理区域信息。
explain_census_geoid将州、县、人口普查区、街区组或街区 GEOID 拆分为各 FIPS 部分,并显示人口普查局使用的区号(012405 即 124.05)。支持离线使用。

两个查询工具都接受可选的 vintage。默认值 current 使用当前地理区域。census2020 使用 2020 年人口普查地理区域,acs2017 到 acs2026 则对应相应版本的美国社区调查。

每个结果都包含结构化 JSON、一段摘要、as_of、source(准确的美国人口普查地理编码器请求)、该人口普查区在 data.census.gov 上的资料链接,以及 more(mcpstamp.com 上的页面)。

它知道而你的模型不知道的信息

  • 给定地址属于哪个人口普查区。人口普查区边界沿街道、河流和铁路划分,同一条街道的两侧可能属于不同人口普查区。模型无法仅凭地址推断这些信息。
  • 人口普查数据、CRA、LIHTC 和补助资格名单使用的 11 位、12 位和 15 位 GEOID。
  • 美国人口普查局目前为该地点发布的国会和州立法选区。

安装

托管服务(Claude.ai 自定义连接器、ChatGPT 开发者模式)

粘贴此 URL。无需令牌或注册。现在即可使用。

https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp
Claude Code
claude mcp add --transport http census-tract https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp
Claude Desktop

在 Claude Desktop 的 Settings、Connectors、Add custom connector 下添加远程服务。粘贴上面的 URL。

Cursor

添加到 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "census-tract": { "url": "https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp" }
  }
}
VS Code

添加到 .vscode/mcp.json:

{
  "servers": {
    "census-tract": { "type": "http", "url": "https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp" }
  }
}
本地 stdio(npm 发布后)

npm 包尚未发布。发布后,可使用 Node 20 或更高版本在本地运行:

claude mcp add census-tract -- npx -y address-to-census-tract-mcp

示例提示词

  • “1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102 属于哪个人口普查区?”
  • “请提供此地址对应的 11 位人口普查区 GEOID 和街区组。”
  • “41.8827, -87.6237 属于哪个人口普查区和国会选区?”
  • “1600 Pennsylvania Ave NW, Washington, DC 对应的 2020 年人口普查区是什么?”
  • “GEOID 060750124053007 表示什么?”

数据来源

完整列表及获取日期见 DATA_SOURCES.md。

限制

  • 仅支持美国地址。
  • 美国人口普查地理编码器会根据人口普查地址范围匹配街道地址。邮政信箱、乡村邮路和非常新的街道可能无法匹配。遇到这种情况,请使用坐标工具。
  • 如果一个地址匹配多条记录,则使用第一条,并将其余记录列在 other_matches 中。
  • 地理编码器可能响应较慢。工具最多等待 30 秒,之后会返回明确的错误,而不是猜测结果。

更多信息

更多能回答助手无法独自回答的问题的 MCP 服务,请访问 mcpstamp.com。

这是 Zovo MCP 系列的一部分:https://mcp.zovo.one

由 theluckystrike 构建。

Development

npm install
npm test                              # builds, then runs the fixture tests and an offline stdio test
node scripts/stdio-transcript.mjs     # live stdio round trip, writes .live/stdio-transcript.jsonl

License

MIT

评论

支持 Markdown

第一次接触 MCP?

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

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