mcpField
G
GridPin offline geocoder

GridPin offline geocoder

ローカル
gridpin.dev地図・旅行41 日前に更新
リポジトリ公式サイト

GridPin offline geocoder について

GridPin offline geocoderは、住所検索のクエリを端末外へ送らずに利用できる、エージェント向けMCPサーバーです。ローカルのメモリマップ方式の国別ファイルを使い、ジオコーディング、逆ジオコーディング、バッチ処理に対応します。

主な機能

  1. 01オフライン住所ジオコーディング
  2. 02座標から住所を逆引き
  3. 031回で最大1,000件のバッチ処理
  4. 04SHA-256による国別ファイルの検証

活用シーン

  1. 01住所の座標をオフラインで検索
  2. 02座標から近隣住所を検索
  3. 03同じ国の住所を一括処理

MCP 対応

MCPサーバーは、対象国の一覧、国別ファイルのダウンロードと検証、住所のジオコーディング、座標からの逆ジオコーディング、バッチ処理のツールを提供します。ネットワークを使うのはファイルのダウンロード時のみです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "gridpin-gridpin": {
      "command": "uvx",
      "args": [
        "gridpin-mcp"
      ],
      "env": {
        "GRIDPIN_HOME": "<GRIDPIN_HOME>"
      }
    }
  }
}
起動コマンドuvx gridpin-mcp
設定が必要な環境変数
GRIDPIN_HOMEDirectory for downloaded country sheets (default: ~/.cache/gridpin)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypigridpin-mcp0.1.0

ツール

5

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

gridpin-mcp — AI エージェント向けのオフラインジオコーディング

GridPin を使ってエージェントが住所をジオコーディングできる MCP サーバーです。国ごとにメモリマップドファイルを用意し、お使いのマシン上で読み込みます。 API キーもレート制限もなく、検索クエリがマシンの外に送信されることもありません。ネットワークを使うのは、国別シートを一度ダウンロードするときだけです。ダウンロードしたシートは、署名済みの GridPin リリースと照合して検証されます。

対象国（リリース v0.4.0）：ブラジル、フランス、ドイツ、イタリア、オランダ、セルビア、スペイン。

エージェントに追加する

Claude Code：

$ claude mcp add gridpin -- uvx gridpin-mcp

mcpServers の設定を読み込む任意のクライアント（Claude Desktop、Cursor など）：

{ "mcpServers": { "gridpin": { "command": "uvx", "args": ["gridpin-mcp"] } } }

エージェント向けの手順を追ったセットアップ（要件、設定、検証）：llms-install.md。

ツール

ツール機能
list_countries対象国、シートのサイズ、ダウンロード済みかどうか
download_sheet国別シートを1つ取得（32-677 MB）して SHA-256 を検証します。ネットワークを使用する唯一のツールです
geocode住所テキスト -> lat、lon、precision、confidence を含む、順位付けされた候補
reverse座標 -> distance_m を含む、最寄りのインデックス登録済み住所
batch1回の呼び出しで、1か国につき最大1000件の住所を入力順に処理

結果は GridPin CLI、Python、DuckDB が返すものと同じです。street または city の精度は概算として扱ってください。

MCP を使わずにシートをダウンロードする

$ pip install gridpin-mcp
$ gridpin-fetch fr          # prints the path, e.g. ~/.cache/gridpin/v0.4.0/france.bin

import gridpin
from gridpin_mcp import sheets

path = sheets.download("fr")   # no-op when already downloaded
gridpin.Geocoder(str(path)).geocode("1 rue de la Paix, Paris", 1)

シートの保存先は $GRIDPIN_HOME、設定されていない場合は $XDG_CACHE_HOME/gridpin、それも設定されていない場合は ~/.cache/gridpin です。 すべてのシートのサイズと SHA-256 は、署名済みリリースのアテステーションに基づいてパッケージに固定されています。一致しないダウンロードは破棄されます。

ライセンス

Apache-2.0。シートデータについては帰属表示をご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。