英国邮编 MCP 服务器

<img src="readme_files/logo.png" width="300" height="300" />

概述

英国邮编 MCP 服务器提供了一种与英国邮编 API (postcodes.io) 交互的有效方式。它为英国邮编提供验证、查找和地理搜索功能。

功能

• 验证 英国邮编
• 检索 邮编详细信息
• 批量邮编查找
• 查找最近的邮编 (通过坐标)

依赖

• Python 3.8+
• mcp-cli & httpx

安装步骤

1. 使用官方独立安装程序安装 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

2. 克隆仓库

然后将 MCP 添加到您的项目依赖项：

uv add "mcp[cli]"

3. 确保已从 Claude 安装 Claude 桌面应用程序

4. 现在将英国邮编 MCP 服务器安装到 Claude 桌面

mcp install postcodes.py

成功安装后，您将看到如下输出

INFO     Added server 'postcodes' to Claude config                                                      claude.py:129
INFO     Successfully installed postcodes in Claude app                                                    cli.py:467

用法

该服务器提供了多种与英国邮编数据交互的方法：

• 查找单个邮编的详细信息
• 执行批量邮编查找
• 通过地理坐标查找最近的邮编

Claude 桌面演示：

API 接口

接口	描述
/lookup/{postcode}	检索单个邮编的详细信息
/bulk-lookup	一次查找多个邮编
/nearest?lat={lat}&lon={lon}	根据坐标查找最近的邮编

---

📌 贡献

欢迎贡献！请随时提交问题或拉取请求。

📄 许可证

本项目采用 MIT 许可证。

⭐ 支持

如果您觉得这个项目有用，请 ⭐ star 这个仓库！并在 LinkedIn 上找到我

---

用 ❤️ 开发，服务于英国邮编。