MCP Geo

🚀 MCP-Geo

GeoPYを利用したMCP地理コーディングサーバーです！GeoPYを使って、地理的な情報を効率的に取得できます。

🚀 クイックスタート

1. 必要な依存関係をインストールします。

   pip install -r requirements.txt
   

2. 環境変数を設定します（オプション）。 必要に応じて、以下の環境変数を設定します。

   export GEOCODER_PROVIDER="nominatim"  # オプション：nominatim、arcgis または bing
   export NOMINATIM_URL="nominatim.openstreetmap.org"  # オプション：Nominatim ドメイン
   export SCHEME="http"  # オプション：http または https
   export ARC_USERNAME="your_arcgis_username"  # オプション：ArcGIS ユーザー名
   export ARC_PASSWORD="your_arcgis_password"  # オプション：ArcGIS パスワード
   export BING_API_KEY="your_bing_maps_key"  # 必須（Bingのみ）
   

3. サーバーを起動します。

   python server.py
   

✨ 主な機能

このMCPサーバーは、大規模言語モデル (LLMs) 向けに以下の地理コーディングツールを提供します。

geocode_location

• ユーザーが提供した住所または地名を受け取り、最適な緯度、経度、および整形された住所を返します。
• 場所が見つからない場合やエラーが発生した場合、エラーを処理してNoneを返します。

reverse_geocode

• 緯度と経度を受け取り、最寄りの住所を返します。
• 地図上のある点の説明情報を取得するために使用します。

geocode_with_details

• geocode_locationに似ていますが、地理コーダーがサポートしている場合、境界ボックスやその他の詳細な住所情報など、より多くのデータを返します。

geocode_multiple_locations

• 住所文字列のリストを受け取り、各住所の緯度と経度を返します。
• 複数の場所の一括処理をサポートします。

reverse_geocode_multiple_locations

• 緯度と経度のリストを受け取り、各座標の最寄りの住所を返します。
• 一括逆地理コーディング操作に適しています。

📦 インストール

📋 システム要件

• Python 3.6+

📦 依存関係

すべての必須依存関係をインストールします。

# uvを使用
uv 同步

必須パッケージ

• fastmcp：モデルコンテキストプロトコルサーバーを構築するフレームワーク
• geoPy：住所または場所にアクセスし、地理コーディング/逆地理コーディングを行うためのPythonライブラリ。

すべての依存関係は requirements.txt にリストされており、簡単にインストールできます。

🛡️ セキュリティ機能

• すべての地理コーディングリクエストは、データ転送の安全性を確保するため、デフォルトでHTTPSを通じて行われます。
• レート制限とAPIキー認証（Bing地理コーダーに対して）をサポートしています。

📚 ドキュメント

サーバーを拡張またはカスタマイズする方法については、geo.py と server.py ファイルを参照してください。必要に応じて、より多くの地理コーディング機能を追加したり、既存のロジックを調整したりできます。

🔧 技術詳細

環境変数

これらの変数は、シェルで設定するか、MCP設定ファイルで環境に応じて構成できます。より多くのカスタマイズが必要な場合は、geo.py ファイルを編集し、必要な地理コーダーパラメータを追加してください。