930m310n/geomelon-mcp

MCP server for the Geomelon geographic API. Exposes cities, countries, regions, and languages as tools any MCP-compatible AI client can call.
Looking for other ways to integrate? See all official libraries at geomelon.dev/libraries.
Two transports are included:
| Binary | Transport | Use case |
|---|---|---|
| geomelon-mcp | stdio | Claude Desktop, Cursor, Cline, Continue |
| geomelon-mcp-http | HTTP (Streamable) | Claude Code, remote / hosted server |
Requirements
- Node.js 18+
- A RapidAPI key with the Geomelon API subscribed — optional, see keyless demo mode below
---
Keyless demo mode
No GEOMELON_API_KEY? Run the server anyway — it starts up with just the search_cities_autocomplete tool, backed by the free oneshot host, no signup required. Every other tool needs a key. This is the fastest way to try the server before subscribing on RapidAPI.
Try it with zero setup
Geomelon also runs a public hosted instance of this same keyless demo — no npx, no local process. Point any remote-MCP-capable client (Claude web/desktop connectors, ChatGPT connectors, MCP Inspector, etc.) at:
It exposes only search_cities_autocomplete, same as running the server yourself with no API key. For the full 22-tool set, run your own instance (below) with your RapidAPI key.
---
Claude Code (HTTP)
Create a .env file in the directory you'll run the server from:
Start the server (dotenv loads .env automatically):
Register it with Claude Code:
Verify it's connected:
The server must be running whenever you use Claude Code. To use a different port set PORT=your_port and update the URL in the claude mcp add command accordingly.
---
Claude Desktop (stdio)
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Restart Claude Desktop after saving.
---
Cursor / Windsurf / Cline (stdio)
Add to your editor's MCP config:
---
Remote / hosted HTTP server
Create a .env file on your server:
Start the server:
Then register with any MCP client using http://your-host:3000/mcp as the URL.
The HTTP transport is stateless — each request is independent, no session management needed. CORS is wide open (Access-Control-Allow-Origin: *) since this transport is meant to be reachable by browser-based remote-MCP clients too. GET / (or /health) returns a small JSON status object — useful for uptime checks — reporting whether the instance has a key configured ("mode": "full" or "mode": "keyless-demo").
---
Available tools
Cities
| Tool | Description |
|---|---|
| search_cities | Search by name, country code, region, population range, sort order |
| get_city | Full details for a city by UUID |
| get_city_translations | All name translations for a city by UUID |
| get_city_settlement_types | Settlement-type classifications for a city by UUID |
| cities_by_coordinates_closest | Cities nearest to a lat/lon, ordered by distance |
| cities_by_coordinates_largest | Largest cities near a lat/lon, ordered by population |
| cities_distance | Distance in km between two cities |