Australian Postcodes MCP

🚀 オーストラリア郵便番号MCPサーバー

高性能なMCP（Model Context Protocol）サーバーで、オーストラリアの郵便番号と郊外のデータを提供します。インテリジェントなファジーマッチング機能を備え、カスタマーサービスの対話を扱うAIアシスタントに特化して設計されています。

✨ 主な機能

🔍 コア検索機能

• 郵便番号から郊外：指定した郵便番号に属するすべての郊外を検索します。
• 郊外から郵便番号：郊外名から郵便番号を検索します（ファジーマッチング機能付き）。
• スマートバリデーション：郊外と郵便番号の組み合わせが正しいかを検証します。
• 地方自治体クエリ：地方自治体（市や議会）内のすべての郊外を一覧表示します。

🎯 AI最適化機能

• ファジーマッチング：タイプミスや誤字を自信度スコア付きで処理します。
• 音声検索：誤聴される可能性のある口頭での名称をマッチングします。
• オートコンプリート：部分的な郊外名に対する候補を提案します。
• スマート提案：完全一致が見つからない場合に代替案を提供します。
• 地理的検索：指定した半径内の近隣の郊外を検索します。

📊 データカバレッジ

• 約17,000のオーストラリアの郵便番号と郊外
• 地方自治体（LGA）
• 統計区域（SA3/SA4）
• 地理座標（緯度/経度）
• 選挙区
• 州および地域情報

🚀 クイックスタート

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/australian-postcodes-mcp.git
cd australian-postcodes-mcp

# 依存関係をインストールする
pip install -r requirements.txt

# 郵便番号データをインポートする
python src/utils/data_loader.py

# ローカルでテストする
fastmcp dev src/server.py

Claude Desktopでの使用方法

Claude Desktopの設定に以下を追加します。

{
  "mcpServers": {
    "australian-postcodes": {
      "command": "fastmcp",
      "args": ["run", "/path/to/australian-postcodes-mcp/src/server.py"]
    }
  }
}

💻 使用例

基本的な使用法

# 郵便番号2300の郊外を検索する
result = await search_by_postcode("2300")
# 返り値: Newcastle, Newcastle West, など

# 郊外の郵便番号を検索する
result = await search_by_suburb("Newcastle", state="NSW")
# 返り値: 2300

高度な使用法

# 誤字を処理する
result = await find_similar_suburbs("Newcaslte", state="NSW")
# 返り値: Newcastle (信頼度: 0.92), New Lambton (信頼度: 0.75)

# 音声検索
result = await phonetic_search("new castle")
# 返り値: Newcastle, Newcastle West

# ニューカッスル地方自治体内の郊外を一覧する
result = await list_suburbs_in_lga("Newcastle", state="NSW")
# 返り値: ニューカッスル市議会管轄内のすべての郊外

📚 ドキュメント

利用可能なツール

検索ツール

• search_by_postcode - 郵便番号から郊外を検索します。
• search_by_suburb - 郊外から郵便番号を検索します。
• validate_suburb_postcode - 郊外と郵便番号の組み合わせが有効かを検証します。
• get_location_details - 郵便番号または郊外名を受け取るスマート検索です。

ファジーマッチングツール

• find_similar_suburbs - 誤字のある郊外名に最も近いマッチを検索します。
• autocomplete_suburb - 部分的な名前に対する候補を取得します。
• validate_spelling - スペルの修正案を提案します。
• phonetic_search - 誤聴された名前を処理します。

場所ツール

• list_suburbs_in_lga - 地方自治体内のすべての郊外を一覧します。
• find_lga_for_suburb - 郊外の地方自治体/市を取得します。
• list_suburbs_in_radius - 指定した半径内の近隣の郵便番号を検索します。
• get_neighboring_suburbs - 隣接する地域を検索します。

分析ツール

• get_state_statistics - 州ごとの郵便番号と郊外の数を取得します。
• list_all_lgas - 利用可能な地方自治体を一覧します。
• search_by_region - 統計区域でクエリを実行します。

🔧 技術詳細

デプロイメント

FastMCPクラウド（推奨）

1. GitHubにプッシュします。
2. fastmcp.cloudでリポジトリを接続します。
3. 環境変数を設定します。
4. ワンクリックでデプロイします。

ローカル開発

# 開発サーバーを起動する
fastmcp dev src/server.py

# 本番サーバーを起動する
python src/server.py

データソース

データは、コミュニティが管理するAustralian Postcodesリポジトリから取得されています。

パフォーマンス

• 高速クエリ用に最適化されたインデックスを持つSQLite
• ほとんどのクエリで100ms未満の応答時間
• rapidfuzzライブラリを使用した効率的なファジーマッチング
• 音声クエリ用のキャッシュされた音声エンコーディング

🤝 コントリビューション

コントリビューションを歓迎します！詳細なガイドラインはCONTRIBUTING.mdを参照してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

🆘 サポート

問題や質問がある場合は、GitHubでイシューを作成するか、メンテナに連絡してください。

FastMCPを使用して、Model Context Protocol用に構築されています。