关于 Address to Census Tract MCP
Address to Census Tract MCP 让 AI 助手通过街道地址或坐标查询美国人口普查地理信息,数据来自美国人口普查局地理编码器。它还可解析 GEOID,并支持当前或指定年份的地理区划,无需 API 密钥。
主要功能
- 01按美国地址查询地理信息
- 02按坐标查询地理信息
- 03返回普查区、区块及选区标识
- 04离线解析 GEOID 组成
- 05选择普查年份版本
适用场景
- 01查询地址对应的普查区和 GEOID
- 02确定坐标对应的各级选区
- 03将 GEOID 拆解为 FIPS 部分
MCP 相关
向 MCP 客户端提供地址和坐标查询工具,以及离线 GEOID 解析工具。托管端点使用 HTTP;README 还介绍了计划中的本地 stdio 选项。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://address-to-census-tract-mcp.lipmichal.workers.dev/mcpclaude mcp add --transport http theluckystrike-address-to-census-tract https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp{"mcpServers":{"theluckystrike-address-to-census-tract":{"type":"http","url":"https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp"}}}在 Cursor 中打开{"servers":{"theluckystrike-address-to-census-tract":{"type":"http","url":"https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"theluckystrike-address-to-census-tract":{"type":"http","url":"https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp"}}}{"mcpServers":{"theluckystrike-address-to-census-tract":{"serverUrl":"https://address-to-census-tract-mcp.lipmichal.workers.dev/mcp"}}}命令在终端中运行;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。
- 地址匹配和地理区域信息来自美国人口普查局地理编码器,基准为
Public_AR_Current。 - 州 FIPS 代码来自人口普查州参考文件。
限制
- 仅支持美国地址。
- 美国人口普查地理编码器会根据人口普查地址范围匹配街道地址。邮政信箱、乡村邮路和非常新的街道可能无法匹配。遇到这种情况,请使用坐标工具。
- 如果一个地址匹配多条记录,则使用第一条,并将其余记录列在
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
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。