# 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"]
    }
  }
}
```