使用说明
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-mcp
3.使用Claude代码进行配置
claude mcp add --transport stdio postaldatapi -- \
env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp
4.使用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
}