PostalDataPI MCP服务器
  
MCP(模型上下文协议)服务器 邮政数据 --让人工智能代理跨平台查找、验证和搜索邮政编码 240多个国家和地区 具有丰富的元数据:时区、行政区域、标高和坐标。
工具
| 工具 | 说明 |
|---|---|
lookup_postal_code | 获取城市、州/地区和邮政编码的缩写(美国邮政编码、英国邮政编码、德国PLZ等) |
validate_postal_code | 检查一个国家是否存在邮政编码 |
search_by_city | 查找一个城市的所有邮政编码 |
get_postal_code_metadata | 完整元数据:坐标、管理员层次结构、时区、标高等 |
设置
1.获取API密钥
注册地址: postaldatapi.com/register --1000次免费查询,无需信用卡。
2.安装
pip install postaldatapi-mcp3.使用Claude代码进行配置
claude mcp add --transport stdio postaldatapi -- \
env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp4.使用Claude Desktop进行配置
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):
{
"mcpServers": {
"postaldatapi": {
"command": "postaldatapi-mcp",
"env": {
"POSTALDATAPI_KEY": "your_api_key_here"
}
}
}
}用法
配置后,自然地问Claude:
- “邮政编码90210是哪个城市?”
- “查找英国邮政编码SW1A”
- “10115是有效的德国邮政编码吗?”
- “加利福尼亚州比佛利山庄的邮政编码是什么?”
- “获取日本邮政编码100-0001的坐标”
Claude将自动使用PostalDataPI工具进行回答。
支持的国家
240多个国家和地区,包括美国、英国、加拿大、德国、法国、日本、澳大利亚、巴西、印度等。查看完整列表 postaldatapi.com/countries.
元数据
除了基本的查找 get_postal_code_metadata 该工具每个邮政编码最多返回18个字段,包括:
- 坐标 (纬度、经度)
- 时区 (例如。,
America/Mexico_City,Europe/Berlin) - 行政层级 (州/省、县、市)
- 海拔 (海拔米)
- 地名 以及国家信息
墨西哥城06000的示例响应:
{
"postalCode": "06000",
"country": "MX",
"placeName": "Centro",
"latitude": 19.4364,
"longitude": -99.1553,
"timezone": "America/Mexico_City",
"adminLevel1": "Ciudad de México",
"adminLevel2": "Cuauhtémoc",
"elevation": 2239
}链接
-
