io.github.wtronk/geolocation-mcp
Geolocation tools (reverse geocoding, ip lookup, etc) using Jeleo Geolocation API
Que pouvez-vous faire avec 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.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
ghcr.io/wtronk/geolocation-mcp:v1.0.0claude 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
{
"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"
}
}
}
}
Variables d'environnement
YOUR_API_KEYobligatoire secret Your API key for the serviceJELEO_API_URLBase URL for the Jeleo Geolocation API
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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:
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"]
}
}
}
Questions fréquentes
Qu'est-ce que io.github.wtronk/geolocation-mcp ?
Geolocation tools (reverse geocoding, ip lookup, etc) using Jeleo Geolocation API
Comment installer io.github.wtronk/geolocation-mcp ?
Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.wtronk/geolocation-mcp ?
Oui. Il attend YOUR_API_KEY, à renseigner dans sa configuration.
io.github.wtronk/geolocation-mcp est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.wtronk/geolocation-mcp ?
Il est publié par wtronk. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.