mcpField
G
GridPin offline geocoder

GridPin offline geocoder

本地服务
gridpin.dev地图与出行4今天更新
代码仓库访问官网

关于 GridPin offline geocoder

GridPin 离线地理编码器是供 Agent 查询地址的 MCP 服务，查询数据不会离开本机。它使用本地内存映射的国家数据文件，支持正向和反向地理编码及批量处理。

主要功能

  1. 01离线地址地理编码
  2. 02从坐标反查地址
  3. 03单次批量处理最多 1,000 个地址
  4. 04通过 SHA-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 Agent 的离线地理编码

一个 MCP 服务，让 Agent 使用 GridPin 对地址进行地理编码：每个国家对应一个内存映射文件，数据在你的设备上读取。 无需 API 密钥，不受速率限制，查询不会离开设备。唯一需要联网的步骤是下载一次国家数据文件，并根据已签名的 GridPin 版本进行验证。

国家（版本 v0.4.0）：巴西、法国、德国、意大利、荷兰、塞尔维亚、西班牙。

将其添加到 Agent

Claude Code：

$ claude mcp add gridpin -- uvx gridpin-mcp

任何读取 mcpServers 配置的客户端（Claude Desktop、Cursor 等）：

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

面向 Agent 的分步设置指南（要求、设置、验证）：llms-install.md。

工具

工具功能
list_countries列出覆盖的国家、数据文件大小及已下载的国家
download_sheet下载一个国家的数据文件（32-677 MB），并验证其 SHA-256；这是唯一会联网的工具
geocode地址文本 -> 按排名排列的候选结果，包含 lat、lon、precision、confidence
reverse坐标 -> 最近的索引地址，包含 distance_m
batch每次调用可处理同一国家的最多 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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。