Geomelon

Un MCP de datos geográficos que cubre ciudades, países, regiones e idiomas, con soporte multilingüe.

Documentación

geomelon-mcp

Servidor MCP para la API geográfica de Geomelon. Expone ciudades, países, regiones e idiomas como herramientas que cualquier cliente de IA compatible con MCP puede llamar.

¿Buscas otras formas de integrarte? Consulta todas las bibliotecas oficiales en geomelon.dev/libraries.

Se incluyen dos transportes:

Binario	Transporte	Caso de uso
`geomelon-mcp`	stdio	Claude Desktop, Cursor, Cline, Continue
`geomelon-mcp-http`	HTTP (Streamable)	Claude Code, servidor remoto / alojado

Requisitos

Node.js 18+
Una clave de RapidAPI con la API de Geomelon suscrita — opcional, consulta el modo de demostración sin clave a continuación.

Modo de demostración sin clave

¿No tienes GEOMELON_API_KEY? Ejecuta el servidor de todos modos: se inicia solo con la herramienta search_cities_autocomplete, respaldada por el host oneshot gratuito, sin necesidad de registro. Todas las demás herramientas necesitan una clave. Esta es la forma más rápida de probar el servidor antes de suscribirte en RapidAPI.

Pruébalo sin configuración

Geomelon también ejecuta una instancia pública alojada de esta misma demostración sin clave: sin npx, sin proceso local. Apunta cualquier cliente compatible con MCP remoto (conectores web/escritorio de Claude, conectores de ChatGPT, MCP Inspector, etc.) a:

https://mcp.geomelon.dev/mcp

Expone solo search_cities_autocomplete, igual que ejecutar el servidor tú mismo sin clave de API. Para el conjunto completo de 22 herramientas, ejecuta tu propia instancia (abajo) con tu clave de RapidAPI.

Claude Code (HTTP)

Crea un archivo .env en el directorio desde el que ejecutarás el servidor:

cp .env.example .env
# then edit .env and set GEOMELON_API_KEY

Inicia el servidor (dotenv carga .env automáticamente):

npx geomelon-mcp-http

Regístralo con Claude Code:

claude mcp add --transport http geomelon http://localhost:3000/mcp

Verifica que esté conectado:

claude mcp list

El servidor debe estar en ejecución siempre que uses Claude Code. Para usar un puerto diferente, establece PORT=your_port y actualiza la URL en el comando claude mcp add en consecuencia.

Claude Desktop (stdio)

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "geomelon": {
      "command": "npx",
      "args": ["-y", "geomelon-mcp"],
      "env": {
        "GEOMELON_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor / Windsurf / Cline (stdio)

Añade a la configuración MCP de tu editor:

{
  "geomelon": {
    "command": "npx",
    "args": ["-y", "geomelon-mcp"],
    "env": {
      "GEOMELON_API_KEY": "your_rapidapi_key_here"
    }
  }
}

Servidor HTTP remoto / alojado

Crea un archivo .env en tu servidor:

cp .env.example .env
# set GEOMELON_API_KEY and PORT in .env

Inicia el servidor:

npx geomelon-mcp-http

Luego regístralo con cualquier cliente MCP usando http://your-host:3000/mcp como URL.

El transporte HTTP es sin estado: cada solicitud es independiente, no se necesita gestión de sesiones. CORS está completamente abierto (Access-Control-Allow-Origin: *) ya que este transporte está pensado para ser accesible también por clientes MCP remotos basados en navegador. GET / (o /health) devuelve un pequeño objeto JSON de estado, útil para comprobaciones de disponibilidad, que informa si la instancia tiene una clave configurada ("mode": "full" o "mode": "keyless-demo").

Herramientas disponibles

Ciudades

Herramienta	Descripción
`search_cities`	Buscar por nombre, código de país, región, rango de población, orden de clasificación
`get_city`	Detalles completos de una ciudad por UUID
`get_city_translations`	Todas las traducciones de nombre de una ciudad por UUID
`get_city_settlement_types`	Clasificaciones de tipo de asentamiento para una ciudad por UUID
`cities_by_coordinates_closest`	Ciudades más cercanas a una lat/lon, ordenadas por distancia
`cities_by_coordinates_largest`	Ciudades más grandes cerca de una lat/lon, ordenadas por población
`cities_distance`	Distancia en km entre dos ciudades

Países

Herramienta	Descripción
`list_countries`	Listar países, filtrar por prefijo de nombre o código telefónico de marcación
`get_country`	Detalles completos de un país por UUID (incluye traducciones y regiones)
`get_country_translations`	Traducciones de nombre de un país por UUID
`get_country_regions`	Todas las regiones administrativas de un país por UUID

Regiones

Herramienta	Descripción
`list_regions`	Listar regiones, filtrar por UUID de país
`get_region`	Detalles completos de una región por UUID
`get_region_translations`	Traducciones de nombre de una región por UUID

Idiomas

Herramienta	Descripción
`list_languages`	Listar todos los idiomas en la base de datos
`get_language`	Detalles de un idioma por UUID

Búsqueda de prefijo oneshot (gratuita, sin clave de API)

Herramienta	Descripción
`search_cities_autocomplete`	Búsqueda de prefijo de nombre de ciudad específica de idioma y limitada a país, respaldada por archivos estáticos preconstruidos. La única herramienta disponible en el modo de demostración sin clave. También funciona en modo con clave: es la ruta de búsqueda más rápida.

Consulta geomelon.dev/free-city-autocomplete-api para ver los pares de país/idioma admitidos y el endpoint HTTP subyacente.

Herramientas compuestas

Estas herramientas encadenan múltiples llamadas a la API internamente para ahorrar viajes de ida y vuelta.

Herramienta	Descripción
`find_cities_near_city`	Dado un UUID de ciudad, encuentra ciudades cercanas ordenadas por distancia o población
`city_context`	Obtén una ciudad junto con los detalles completos de su país y región en una sola llamada
`country_overview`	Obtén un país (por UUID o nombre), sus regiones y las principales ciudades por población
`compare_cities`	Obtén dos ciudades y la distancia entre ellas en una sola llamada
`search_cities_in_country`	Busca ciudades usando un nombre de país en lugar de un código ISO