English Français العربية

io.github.wtronk/geolocation-mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.wtronk/geolocation-mcp؟

  • 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

OCI package ghcr.io/wtronk/geolocation-mcp:v1.0.0
Claude Code 
claude mcp add geolocation-mcp -e 'YOUR_API_KEY=<your your_api_key>' -e 'JELEO_API_URL=https://www.jeleo.zone.id/api/geolocation' -- docker run -i --rm ghcr.io/wtronk/geolocation-mcp:v1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "geolocation-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/wtronk/geolocation-mcp:v1.0.0"
            ],
            "env": {
                "YOUR_API_KEY": "<your your_api_key>",
                "JELEO_API_URL": "https://www.jeleo.zone.id/api/geolocation"
            }
        }
    }
}

متغيرات البيئة

  • YOUR_API_KEY إلزامي سري Your API key for the service
  • JELEO_API_URL Base URL for the Jeleo Geolocation API

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. geolocation-mcp
  2. Tools
  3. Configuration
  4. Building and Running Locally
  5. Adding to an MCP Client (e.g. Claude Desktop)

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.

To build the Docker image:

docker build -t geolocation-mcp .

To run it locally via Docker:

docker run -i --rm geolocation-mcp -apikey YOUR_API_KEY
Direct Execution

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

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:

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

الأسئلة الشائعة

ما هو io.github.wtronk/geolocation-mcp؟

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

كيف أثبّت io.github.wtronk/geolocation-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add geolocation-mcp -e 'YOUR_API_KEY=<your your_api_key>' -e 'JELEO_API_URL=https://www.jeleo.zone.id/api/geolocation' -- docker run -i --rm ghcr.io/wtronk/geolocation-mcp:v1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.wtronk/geolocation-mcp إلى مفتاح API؟

نعم. يتطلب YOUR_API_KEY، وتضبطها في إعداداته.

هل io.github.wtronk/geolocation-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.wtronk/geolocation-mcp؟

ينشره wtronk. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.