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 分

    請在儲存庫或註冊中心條目中宣告授權條款。