geolocation-mcp

geolocation-mcp

これは GeoLocation API のラッパーとして動作する Model Context Protocol（MCP）サーバーです。LLM（Claude など）が高速な逆ジオコーディングと一括逆ジオコーディング（IP アドレスと座標を使用）を実行するためのツールを提供します。

ツール

• reverse_geocode：緯度／経度の座標から、位置情報の詳細なメタデータ（都市、国、人口指標、経済データ）を取得します。
• batch_reverse_geocode：1 回のリクエストで複数の地理座標をまとめて解決します。

設定

MCP サーバーには API キーと API ベース URL が必要です。これらは https://jeleo.zone.id/ から取得できます。 サーバーにはコマンドライン引数として渡します。

• -apikey：Jeleo API キー
• -url：Jeleo API のベース URL（デフォルト：https://www.jeleo.zone.id/api/geolocation）

ローカルでのビルドと実行

このサーバーは標準入出力（stdio）で動作します。これは MCP の標準的な方式です。実行可能ファイルとして、または Docker 経由で実行するよう設計されています。

Docker を使用する（レジストリ向けに推奨）

Docker イメージをビルドするには：

docker build -t geolocation-mcp .

Docker 経由でローカル実行するには：

docker run -i --rm geolocation-mcp -apikey YOUR_API_KEY

直接実行

Go がインストールされている場合は、直接ビルドして実行できます。

go build -o geolocation-mcp main.go
./geolocation-mcp -apikey YOUR_API_KEY

MCP クライアント（Claude Desktop など）への追加

イメージをコンテナレジストリに公開済みの場合、またはローカルで使用する場合は、claude_desktop_config.json に追加します。

ローカルの Docker：

{
  "mcpServers": {
    "geolocation": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "geolocation-mcp", "-apikey", "YOUR_API_KEY", "-url", "https://www.jeleo.zone.id/api/geolocation"]
    }
  }
}