io.github.wtronk/geolocation-mcp
Geolocation tools (reverse geocoding, ip lookup, etc) using Jeleo Geolocation API
Open source Open in the app JSON README (API)
About
Geolocation tools (reverse geocoding, ip lookup, etc) using Jeleo Geolocation API
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- wtronk
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Last push
- 2026-03-21T19:32:08Z
- Repository state
- ativo
- Language
- Go
- Added
- 2026-08-29 04:01:41
- Updated
- 2026-08-29 04:01:41
- Origin id
io.github.wtronk/geolocation-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/](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"]
}
}
}
```