Geolocation Mcp

io.github.wtronk由 GitHub 账号 wtronk 发布v1.0.0更新于 Oct 24, 2026

Geolocation tools (reverse geocoding, ip lookup, etc) using Jeleo Geolocation API

已验证STDIO仅桌面位置与生活

概览

AI 生成的概览

让助手通过 Jeleo Geolocation API 把坐标转换为地点信息，并可一次解析多个坐标。

可以做什么
这是一个本地 stdio MCP 服务器，封装了 Jeleo Geolocation API。它提供 reverse_geocode 工具，根据经纬度返回城市、国家、人口指标和经济数据等地点元数据；还提供 batch_reverse_geocode 工具，可在一次请求中解析多个坐标。适合助手进行快速反向地理编码。
适用场景
当助手需要用地名或其他地点元数据标注坐标，或需要批量补充坐标信息时适用。适合把反向地理编码作为常规步骤而非一次性查询的工作流程。
运行要求
以 stdio 方式在本地运行，可使用 Docker 镜像或编译后的 Go 程序。需要 Jeleo API 密钥和 API 基础地址，通过命令行参数 -apikey 和 -url 传入；默认地址为 Jeleo 服务的网络。
安装前请注意
API 密钥以明文命令行参数传入，可能出现在进程列表、shell 历史和客户端配置文件中，应按机密信息处理。坐标数据会发送到第三方 Jeleo 服务。该服务器为只读，不会写入或删除数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Geolocation Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

geolocation-mcp

This is a Model Context Protocol (MCP) server that acts as a wrapper around the GeoLocation API. It provides tools for LLMs (like Claude) to perform fast reverse geocoding and batch reverse geocoding (via IP and coordinates).

Tools

  • reverse_geocode: Get rich location metadata (city, country, population metrics, economic data) from latitude/longitude coordinates.
  • batch_reverse_geocode: Resolve a list of multiple geographic coordinates in a single request.

Configuration

The MCP server requires an API Key and an API Base URL. You can retrieve them from https://jeleo.zone.id/. They are provided to the server as command-line arguments:

  • -apikey: Your Jeleo API Key
  • -url: Base URL for the Jeleo API (default: https://www.jeleo.zone.id/api/geolocation)

Building and Running Locally

The server runs on standard input/output (stdio), which is standard for MCP. It's designed to be run as an executable or via Docker.

Using Docker (Recommended for Registry)

To build the Docker image:

sh
docker build -t geolocation-mcp .

To run it locally via Docker:

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

Direct Execution

If you have Go installed, you can build and run it directly:

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

Adding to an MCP Client (e.g. Claude Desktop)

If you have published the image to a container registry, or just using it locally, add it to your claude_desktop_config.json:

Local Docker:

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

来源：README.md，提交 8d25e94

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。