Postcodes UK MCP Server

Postcodes UK MCP サーバー

概要

Postcodes UK 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 Desktop App をインストールします

4. Postcodes UK MCP サーバーを Claude Desktop にインストールします

mcp install postcodes.py

インストールが成功すると、次のような出力が表示されます。

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

使用方法

このサーバーには、英国の郵便番号データを操作する複数の方法があります。

• 1 件の郵便番号の詳細を検索
• 郵便番号を一括検索
• 地理座標から最寄りの郵便番号を検索

Claude Desktop でのデモ：

API エンドポイント

エンドポイント	説明
/lookup/{postcode}	1 件の郵便番号の詳細を取得
/bulk-lookup	複数の郵便番号を一度に検索
/nearest?lat={lat}&lon={lon}	座標に基づいて最寄りの郵便番号を検索

---

📌 コントリビューション

コントリビューションを歓迎します。お気軽にイシューやプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。

⭐ サポート

このプロジェクトが役に立った場合は、リポジトリに ⭐ を付けてください。また、LinkedIn で私を見つけてください。

---

英国の郵便番号サービスのために ❤️ を込めて開発されました。