mcpField
G
geolocation-mcp

geolocation-mcp

本地服务
github.com/wtronk地图与出行032 周前更新
代码仓库

关于 geolocation-mcp

geolocation-mcp 是封装 Jeleo Geolocation API 的 MCP 服务，面向需要根据坐标获取地点信息的 LLM 应用。它支持单点和批量反向地理编码。

主要功能

  1. 01坐标反向地理编码
  2. 02批量解析多个坐标
  3. 03返回城市与国家等地点信息
  4. 04提供人口和经济数据

适用场景

  1. 01根据坐标补充地点资料
  2. 02批量处理地理坐标
  3. 03在 LLM 工作流中查询地点信息

MCP 相关

通过 stdio 向 MCP 客户端提供反向地理编码和批量反向地理编码工具。运行时需要 Jeleo API 密钥和 API 基础 URL。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "wtronk-geolocation": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "YOUR_API_KEY",
        "-e",
        "JELEO_API_URL",
        "ghcr.io/wtronk/geolocation-mcp:v1.0.0"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>",
        "JELEO_API_URL": "<JELEO_API_URL>"
      }
    }
  }
}
启动命令docker run -i --rm -e YOUR_API_KEY -e JELEO_API_URL ghcr.io/wtronk/geolocation-mcp:v1.0.0
需要配置的环境变量
YOUR_API_KEY密钥Your API key for the service
JELEO_API_URLBase URL for the Jeleo Geolocation API

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/wtronk/geolocation-mcp:v1.0.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

geolocation-mcp

这是一个 Model Context Protocol（MCP）服务，用于封装 GeoLocation API。它提供工具，让大模型（如 Claude）执行快速反向地理编码和批量反向地理编码（通过 IP 和坐标）。

工具

  • reverse_geocode：根据纬度/经度坐标获取丰富的位置元数据（城市、国家、人口指标、经济数据）。
  • batch_reverse_geocode：在单个请求中解析多个地理坐标组成的列表。

配置

MCP 服务需要 API Key 和 API Base URL。你可以从 https://jeleo.zone.id/ 获取。 这些参数通过命令行参数传递给服务：

  • -apikey：你的 Jeleo API Key
  • -url：Jeleo API 的 Base 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"]
    }
  }
}

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。