postcodes-uk-mcp-server

🚀 英国邮编UK MCP服务器

英国邮编UK MCP服务器提供了一种高效途径，可与英国邮编API（postcodes.io）进行交互。它具备邮编验证、检索以及地理搜索等功能，能满足用户对英国邮编相关信息的查询需求。

🚀 快速开始

英国邮编UK MCP服务器提供了便捷的方式与英国邮编API交互，以下是使用前的准备步骤。

✨ 主要特性

• 验证：可对英国邮编进行验证，确保邮编的准确性。
• 获取：能够获取邮编的详细信息。
• 批量邮编查询：支持一次性查询多个邮编的相关内容。
• 通过坐标查找最近的邮编：依据地理坐标查找附近的邮编。

📦 安装指南

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桌面应用程序已从Claude完成安装。

4. 安装英国邮编UK 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许可证。

⭐ 支持

如果您发现这个项目有用，请在GitHub上为它点个星！并可在LinkedIn找到我。