
Postcodes UK MCP Server

2025.04.03
0
Python地图服务位置服务位置服务
Postcodes UK MCP Server 是一个高效的工具,用于与英国邮政编码 API(postcodes.io)进行交互。它提供了验证、查找和地理搜索英国邮政编码的功能。
View on GitHub
Overview
基本能力
产品定位
Postcodes UK MCP Server 是一个专门用于处理英国邮政编码的服务,提供验证、查找和地理搜索功能。
核心功能
- 验证英国邮政编码
- 检索邮政编码详细信息
- 批量邮政编码查找
- 通过坐标查找最近的邮政编码
适用场景
- 需要验证英国邮政编码的场景
- 需要获取英国邮政编码详细信息的场景
- 需要批量处理英国邮政编码的场景
- 需要根据地理坐标查找附近邮政编码的场景
工具列表
mcp-cli
:用于安装和管理 MCP 服务的命令行工具httpx
:用于 HTTP 请求的 Python 库
常见问题解答
- 如何安装?请参考安装步骤。
- 如何使用?请参考使用教程。
- 如何贡献?欢迎提交问题或拉取请求。
使用教程
使用依赖
- Python 3.8+
mcp-cli
和httpx
安装教程
- 安装 uv 官方独立安装程序:
- macOS 和 Linux:
$ curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex
- 克隆仓库并添加 MCP 到项目依赖:
uv add "mcp[cli]"
- 确保已安装 Claude Desktop App(从 Claude 下载)
- 安装 Postcodes UK MCP Server 到 Claude Desktop:
mcp install postcodes.py
调试方式
安装完成后,可以通过以下命令检查服务是否正常运行:
mcp list
确保 postcodes
服务已列出。
API 端点
端点 | 描述 |
---|---|
/lookup/{postcode} |
检索单个邮政编码的详细信息 |
/bulk-lookup |
一次性查找多个邮政编码 |
/nearest?lat={lat}&lon={lon} |
根据坐标查找最近的邮政编码 |