Geomelon

Um MCP de dados geográficos que abrange cidades, países, regiões e idiomas — com suporte multilíngue

Documentação

geomelon-mcp

Servidor MCP para a API geográfica Geomelon. Expõe cidades, países, regiões e idiomas como ferramentas que qualquer cliente de IA compatível com MCP pode chamar.

Procurando outras formas de integrar? Veja todas as bibliotecas oficiais em geomelon.dev/libraries.

Dois transportes estão incluídos:

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

Requisitos

Node.js 18+
Uma chave RapidAPI com a API Geomelon assinada — opcional, veja modo de demonstração sem chave abaixo

Modo de demonstração sem chave

Sem GEOMELON_API_KEY? Execute o servidor mesmo assim — ele inicia apenas com a ferramenta search_cities_autocomplete, apoiada pelo oneshot host gratuito, sem necessidade de cadastro. Todas as outras ferramentas precisam de uma chave. Esta é a maneira mais rápida de experimentar o servidor antes de assinar no RapidAPI.

Experimente com zero configuração

A Geomelon também executa uma instância pública hospedada deste mesmo demo sem chave — sem npx, sem processo local. Aponte qualquer cliente compatível com MCP remoto (conectores Claude web/desktop, conectores ChatGPT, MCP Inspector, etc.) para:

https://mcp.geomelon.dev/mcp

Ele expõe apenas search_cities_autocomplete, o mesmo que executar o servidor você mesmo sem chave de API. Para o conjunto completo de 22 ferramentas, execute sua própria instância (abaixo) com sua chave RapidAPI.

Claude Code (HTTP)

Crie um arquivo .env no diretório a partir do qual você executará o servidor:

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

Inicie o servidor (o dotenv carrega .env automaticamente):

npx geomelon-mcp-http

Registre-o com o Claude Code:

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

Verifique se está conectado:

claude mcp list

O servidor deve estar em execução sempre que você usar o Claude Code. Para usar uma porta diferente, defina PORT=your_port e atualize a URL no comando claude mcp add de acordo.

Claude Desktop (stdio)

Adicione 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"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar.

Cursor / Windsurf / Cline (stdio)

Adicione à configuração MCP do seu editor:

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

Servidor HTTP remoto / hospedado

Crie um arquivo .env no seu servidor:

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

Inicie o servidor:

npx geomelon-mcp-http

Em seguida, registre-se com qualquer cliente MCP usando http://your-host:3000/mcp como URL.

O transporte HTTP é sem estado — cada requisição é independente, sem necessidade de gerenciamento de sessão. O CORS está totalmente aberto (Access-Control-Allow-Origin: *) já que este transporte também deve ser acessível por clientes MCP remotos baseados em navegador. GET / (ou /health) retorna um pequeno objeto de status JSON — útil para verificações de disponibilidade — informando se a instância tem uma chave configurada ("mode": "full" ou "mode": "keyless-demo").

Ferramentas disponíveis

Cidades

Ferramenta	Descrição
`search_cities`	Pesquisar por nome, código do país, região, faixa populacional, ordem de classificação
`get_city`	Detalhes completos de uma cidade por UUID
`get_city_translations`	Todas as traduções de nome de uma cidade por UUID
`get_city_settlement_types`	Classificações de tipo de assentamento para uma cidade por UUID
`cities_by_coordinates_closest`	Cidades mais próximas de uma latitude/longitude, ordenadas por distância
`cities_by_coordinates_largest`	Maiores cidades próximas a uma latitude/longitude, ordenadas por população
`cities_distance`	Distância em km entre duas cidades

Países

Ferramenta	Descrição
`list_countries`	Listar países, filtrar por prefixo do nome ou código de discagem telefônica
`get_country`	Detalhes completos de um país por UUID (inclui traduções e regiões)
`get_country_translations`	Traduções de nome de um país por UUID
`get_country_regions`	Todas as regiões administrativas de um país por UUID

Regiões

Ferramenta	Descrição
`list_regions`	Listar regiões, filtrar por UUID do país
`get_region`	Detalhes completos de uma região por UUID
`get_region_translations`	Traduções de nome de uma região por UUID

Idiomas

Ferramenta	Descrição
`list_languages`	Listar todos os idiomas no banco de dados
`get_language`	Detalhes de um idioma por UUID

Pesquisa de prefixo oneshot (gratuita, sem chave de API)

Ferramenta	Descrição
`search_cities_autocomplete`	Pesquisa de prefixo de nome de cidade específica por idioma e limitada a um país, apoiada por arquivos estáticos pré-construídos. A única ferramenta disponível no modo de demonstração sem chave. Também funciona no modo com chave — é o caminho de pesquisa mais rápido.

Veja geomelon.dev/free-city-autocomplete-api para pares de país/idioma suportados e o endpoint HTTP subjacente.

Ferramentas compostas

Essas ferramentas encadeiam várias chamadas de API internamente para economizar viagens de ida e volta.

Ferramenta	Descrição
`find_cities_near_city`	Dado um UUID de cidade, encontre cidades próximas ordenadas por distância ou população
`city_context`	Busque uma cidade juntamente com os detalhes completos do país e da região em uma única chamada
`country_overview`	Busque um país (por UUID ou nome), suas regiões e as principais cidades por população
`compare_cities`	Busque duas cidades e a distância entre elas em uma única chamada
`search_cities_in_country`	Pesquise cidades usando um nome de país em vez de um código ISO