Postcodes UK MCP Server

Postcodes UK MCP Server

site icon
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-clihttpx

安装教程

  1. 安装 uv 官方独立安装程序:
  2. macOS 和 Linux: $ curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex
  4. 克隆仓库并添加 MCP 到项目依赖: uv add "mcp[cli]"
  5. 确保已安装 Claude Desktop App(从 Claude 下载)
  6. 安装 Postcodes UK MCP Server 到 Claude Desktop: mcp install postcodes.py

调试方式

安装完成后,可以通过以下命令检查服务是否正常运行:

mcp list

确保 postcodes 服务已列出。

API 端点

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

许可证

该项目遵循 MIT 开源许可条款。