关于 Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics
Zip-Codes.com 通过 MCP 服务提供美国地址和邮政编码位置数据,面向需要可靠邮政及地理信息的应用和 Agent。它整合地址验证、地理编码、人口统计和辖区信息,并说明数据来源与更新周期。
主要功能
- 01验证并规范化美国地址
- 02查询 ZIP 和 ZIP+4 详情
- 03地理编码并计算距离
- 04搜索地点及半径范围
- 05补充人口统计和辖区信息
- 06查看数据集来源与版本
适用场景
- 01验证美国街道地址并获取 ZIP+4
- 02查找某地点附近的 ZIP Code
- 03用普查区人口统计数据补充位置记录
- 04查询 ZIP Code 涉及的县和辖区
MCP 相关
远程 MCP 服务提供 11 个工具,用于地址验证、ZIP Code 查询、地点搜索、距离和半径检索及数据参考。客户端通过 Streamable HTTP 连接,并可使用 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.zip-codes.com/mcpclaude mcp add --transport http com-zip-codes-api https://mcp.zip-codes.com/mcp{"mcpServers":{"com-zip-codes-api":{"type":"http","url":"https://mcp.zip-codes.com/mcp"}}}在 Cursor 中打开{"servers":{"com-zip-codes-api":{"type":"http","url":"https://mcp.zip-codes.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-zip-codes-api":{"type":"http","url":"https://mcp.zip-codes.com/mcp"}}}{"mcpServers":{"com-zip-codes-api":{"serverUrl":"https://mcp.zip-codes.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.zip-codes.com/mcp需要授权工具
详细介绍
原文在翻译后有更新,译文可能不是最新。
Zip-Codes.com 位置智能:空间分析、区域划分与 14 年以上的人口统计数据
通过模型上下文协议,为美国地址和 ZIP Code 提供位置智能。Zip-Codes.com 可验证美国街道地址,并通过一次调用返回其 ZIP+4、人口普查区人口统计数据、收入、住房和学区信息。它根据每月更新的 USPS 数据和人口普查边界提供答案,因此 Agent 会查询地址和 ZIP Code,而不是凭空猜测。按需请求所需的增强数据。调查估算描述的是人口普查区,并附有误差范围。
ZIP 边界遵循 USPS 投递路线,并每季度更新。覆盖范围包括人口普查 ZIP 区域文件未涵盖的 PO Box 和单一机构 ZIP Code。边界增强数据会显示某个 ZIP 与哪些县和区域重叠,并按面积计算占比。除地图上的县之外,还提供 USPS 指定的县。
如需历史数据,可请求 2010–2025 年的 Census TIGER/Line 边界。American Community Survey 配置文件在 2011–2024 年各版本的 ZIP Code 区域数据中,以及 2022–2024 年的普查区数据中,均使用一致的字段名称。ZIP 的调查估算来自具有相同代码的 Census ZCTA。
连接
服务 URL:https://mcp.zip-codes.com/mcp(Streamable HTTP)。
Claude Code
claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp
claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp --header "X-Api-Key: YOUR_KEY"
Cursor(~/.cursor/mcp.json)及其他 mcpServers 客户端
{
"mcpServers": {
"zip-codes": {
"url": "https://mcp.zip-codes.com/mcp",
"headers": {
"X-Api-Key": "YOUR_KEY"
}
}
}
}
VS Code(.vscode/mcp.json)
{
"servers": {
"zip-codes": {
"type": "http",
"url": "https://mcp.zip-codes.com/mcp",
"headers": {
"X-Api-Key": "YOUR_KEY"
}
}
}
}
Claude / Claude Desktop 自定义连接器
将 https://mcp.zip-codes.com/mcp 添加为自定义连接器。如果连接器表单中没有 Request headers 部分(目前仅向有限数量的组织提供测试版),连接器将以演示模式运行;如果有,请在其中添加 x-api-key 并填写你的密钥。
工具(11 个)
| 工具 | 标题 | 功能说明 |
|---|---|---|
about_data | 关于这些数据 | 介绍此服务的数据来源:每个数据集背后的权威机构、来源发布版本时所提供的版本(TIGER/Line、ACS、ZCTA)、新版本的获取频率,以及可直接使用的引用文本。 |
city_name_rules | 城市名称规则 | USPS 如何命名 ZIP Code,以及哪些名称可用于邮件。 |
county_reference | 县参考数据 | 美国县及县级等同区域,共 3,235 个,包含其 Census 和 USPS 名称(其中有一百多个名称不一致)、ANSI 代码、法定类型、陆地和水域面积,以及 USPS 投递覆盖范围。 |
distance | 两地之间的距离 | 计算两地之间的距离(英里和公里),以及从第一地到第二地的罗盘方位。 |
metro_area_reference | 都会区参考数据 | 美国大都会和小都会统计区(CBSA),共 935 个。 |
quick_zip | 快速查询 ZIP / ZIP+4 / 反向地理编码 | 快速获取简明的邮政编码信息。 |
radius_search | 半径搜索 | 查找中心点指定半径内的所有美国 ZIP Code 和加拿大邮政区域,并返回各自的距离。 |
suggest_places | 地点搜索(输入联想) | 按部分名称、拼写错误的名称或部分代码搜索地点,将用户输入解析为其他工具可查询的内容。 |
validate_address | 验证美国地址 | 验证并标准化美国街道地址,返回其 ZIP+4。 |
zip_facts | ZIP Code 统计 | 美国 ZIP Code 和加拿大邮政编码统计信息:总数、类型分布、投递点和投递路线总数、各州表格,以及排名列表,例如投递路线最多的 ZIP Code。 |
zip_lookup | ZIP Code 查询 | 邮政编码的完整记录——主要的位置智能工具。 |
定价
无需密钥即可开始使用。免费密钥每天提供 2,500 个额度;套餐和额度包见:https://www.zip-codes.com/api/pricing
支持
发送邮件至 [email protected]。此仓库已关闭 Issues;发送邮件即可联系服务的运营人员。
链接
- 概览:https://www.zip-codes.com/api/mcp
- API 文档:https://api.zip-codes.com/docs
- 面向 Agent 的服务概览:https://mcp.zip-codes.com/llms.txt
许可证
专有。保留所有权利;请参阅 LICENSE。服务、API 和数据的使用受服务条款约束:https://www.zip-codes.com/api/tos
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。