IP2Location.io

Servidor MCP IP2Location.io

O Servidor MCP IP2Location.io é um servidor Model Context Protocol (MCP) que permite que clientes de IA compatíveis com MCP realizem consultas de geolocalização de endereços IP e inteligência de rede usando a API IP2Location.io.

Forneça um endereço IPv4 ou IPv6 e o servidor MCP pode recuperar informações como localização geográfica, ASN, ISP, domínio, tipo de rede e informações de proxy, dependendo do seu plano da API IP2Location.io.

Isso o torna útil para investigação de IP, solução de problemas de rede, análise de tráfego, localização, análise de segurança e enriquecimento de endereços IP encontrados em logs ou outros conjuntos de dados.

Recursos

• Dados abrangentes de geolocalização: recupere país, região, cidade, CEP/código postal, latitude, longitude, fuso horário e outras informações de localização.
• Consulta ASN: identifique o Número de Sistema Autônomo (ASN) e o Sistema Autônomo (AS) associados a um endereço IP.
• Inteligência de rede: recupere informações como ISP, domínio, velocidade de conexão, tipo de uso e outros atributos de rede, dependendo do seu plano.
• Informações de proxy e segurança: detecte informações relacionadas a proxy e, em planos compatíveis, informações adicionais de VPN, Tor, data center, ameaças e fraudes.
• Suporte a IPv4 e IPv6: consulte endereços IPv4 e IPv6.
• Consulta de IP em lote: envie vários endereços IP em um único prompt e use automaticamente a API Bulk do IP2Location.io quando disponível.
• Integração MCP: use a inteligência de IP diretamente de aplicativos de IA compatíveis com MCP.
• Requisições assíncronas: usa httpx para requisições assíncronas à API.

[!NOTE] Os campos retornados pelo IP2Location.io dependem do seu plano de assinatura da API.

Requisitos

Há duas maneiras de usar este servidor MCP.

Servidor MCP hospedado na nuvem

Recomendado quando você deseja conectar-se diretamente ao servidor MCP IP2Location.io hospedado.

Você precisa de:

• Um cliente compatível com MCP, como o Claude Desktop
• Node.js / npx
• Uma chave de API IP2Location.io

Servidor MCP local

Use esta opção quando quiser executar o servidor MCP localmente.

Você precisa de:

• Python 3.13 ou posterior
• uv
• Um cliente compatível com MCP, como o Claude Desktop
• Uma chave de API IP2Location.io

Você pode se cadastrar para obter uma chave de API IP2Location.io gratuita. O plano gratuito oferece até 50.000 consultas de API de geolocalização de IP por mês.

A API REST subjacente do IP2Location.io também suporta acesso limitado sem chave de até 1.000 consultas por dia. Para este servidor MCP, a configuração de uma chave de API é recomendada e é usada nos exemplos de configuração abaixo.

Configuração

Você pode usar este servidor MCP no Claude Desktop de uma das seguintes maneiras:

• Servidor MCP hospedado na nuvem: recomendado se você quiser conectar-se diretamente ao servidor MCP IP2Location.io hospedado.
• Servidor MCP local: use esta opção se quiser baixar e executar o servidor MCP original em sua própria máquina.

Opção 1: Servidor MCP hospedado na nuvem

Siga estas etapas para conectar o Claude Desktop ao servidor MCP IP2Location.io hospedado.

1. Certifique-se de ter instalado o Claude Desktop. Se ainda não o instalou, baixe-o aqui para Windows e macOS, ou siga este guia para usuários de Linux.
2. Abra o arquivo claude_desktop_config.json no editor de sua preferência. Se você ainda não tiver um, siga este guia para criar um.
3. Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

4. Substitua YOUR_API_KEY pela sua chave de API IP2Location.io real. Para obter sua chave de API, faça login no seu painel.
5. Reinicie o Claude Desktop após salvar as alterações, e você deverá ver o servidor MCP aparecer no menu Connectors.

Opção 2: Servidor MCP local

Siga estas etapas se preferir executar o servidor MCP localmente.

1. Configure o gerenciador de pacotes uv. Você pode consultar o guia para fazer isso.
2. Certifique-se de ter instalado o Claude Desktop. Se ainda não o instalou, baixe-o aqui para Windows e macOS, ou siga este guia para usuários de Linux.
3. Abra o arquivo claude_desktop_config.json no editor de sua preferência. Se você ainda não tiver um, siga este guia para criar um.
4. Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

5. Para obter sua chave de API, faça login no seu painel. Substitua <YOUR API key HERE> no exemplo acima pela sua chave de API real.
6. Reinicie o Claude Desktop após salvar as alterações, e você deverá vê-lo aparecer no menu Connectors.

Uso

Depois que o servidor MCP estiver conectado, faça perguntas ao seu cliente MCP sobre um endereço IPv4 ou IPv6 usando linguagem natural. Basta digitar sua consulta sobre o IP em um chat no Claude Desktop.

Geolocalização de IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Por exemplo, abaixo está o resultado do IP 8.8.8.8:

No Claude Desktop, o modelo gerará automaticamente a saída com base no resultado retornado pelo servidor MCP IP2Location.io.

Consulta de proxy e segurança

Dependendo do plano IP2Location.io em uso:

Is this IP address a proxy: 8.8.8.8?

Vários endereços IP

Você também pode utilizar a API Bulk IP Geolocation do IP2Location.io para consultar vários endereços IP.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

O servidor MCP detecta vários endereços IP e os envia para a API Bulk do IP2Location.io quando possível.

Os endereços IP podem ser separados por vírgulas, espaços ou novas linhas.

[!NOTE]
O acesso à API Bulk IP Geolocation do IP2Location.io requer um plano pago elegível.

Variável de Ambiente

IP2LOCATION_API_KEY

Sua chave de API IP2Location.io IP2LOCATION_API_KEY.

O plano gratuito atualmente oferece até 50.000 consultas de API de geolocalização de IP por mês e acesso a informações básicas de IP.

Os planos pagos oferecem cotas de consulta mais altas e atributos adicionais.

Você pode se cadastrar para obter uma chave de API gratuita, ou assinar um plano superior para dados abrangentes de geo-IP.

Não envie sua chave de API para um repositório Git público.

Ferramenta MCP

get_geolocation

Descrição

• Busca geolocalização para o endereço IP fornecido ou um lote de endereços IP. Ajuda os usuários a recuperar informações detalhadas como país, região, cidade, latitude, longitude, CEP, fuso horário, ASN e informações de proxy para qualquer endereço IPv4 ou IPv6. Ele roteia automaticamente as requisições para a API Bulk do IP2Location.io para processamento eficiente quando vários IPs são detectados.

Argumentos

• ip (str): Um endereço IPv4 ou IPv6, ou vários endereços IP separados por vírgulas, espaços ou novas linhas.

Exemplo de IP único:

8.8.8.8

Exemplo de vários IPs:

1.1.1.1, 8.8.8.8, 9.9.9.9

Valor de retorno Uma string JSON contendo os dados de geolocalização. Se vários IPs forem consultados, retorna um objeto JSON onde cada chave é um endereço IP mapeado para seus respectivos dados.

Dependendo do seu plano de API, as informações retornadas podem incluir:

Categoria	Informações possíveis
Localização e Geografia	País, região, distrito, cidade, CEP, latitude, longitude, fuso horário
Rede e Conectividade	ASN, ISP, domínio, velocidade de rede, código IDD, código de área, tipo de endereço, tipo de uso
Sistema Autônomo	ASN, nome do AS e, em planos compatíveis, domínio do AS, CIDR do AS e tipo de uso do AS
Celular	MCC, MNC, marca de celular
Moeda e Idioma	Código/nome/símbolo da moeda e informações de idioma
Proxy e Segurança	Status/tipo de proxy, provedor, última visualização, informações de ameaça e pontuação de fraude
Outros Dados	Categoria IAB, informações meteorológicas, elevação, população e outros dados dependentes do plano

Se uma requisição de IP único falhar ou o IP for inválido, a ferramenta retorna uma mensagem de erro como string. Para requisições em lote, qualquer IP individual que falhar retornará um objeto de erro mapeado para esse endereço IP específico sem falhar todo o lote.

Perguntas Frequentes

Você pode recomendar serviços gratuitos de geolocalização de IP?

Sim. IP2Location.com e IP2Location.io fornecem acesso gratuito ou níveis gratuitos.

IP2Location.io

O IP2Location.io fornece um plano gratuito adequado para geolocalização de IP e consulta básica de rede.

O plano gratuito inclui até 50.000 consultas de API de geolocalização de IP por mês e fornece informações básicas, incluindo:

• Endereço IP
• País
• Região
• Cidade
• CEP/código postal
• Latitude e longitude
• Fuso horário
• ASN
• Nome do AS
• Detecção básica de proxy

A API REST do IP2Location.io também pode ser consultada sem chave de API para uso limitado de até 1.000 requisições por dia.

O plano gratuito requer atribuição. Verifique a página de preços do IP2Location.io para limites e condições atuais.

Para aplicativos MCP que precisam de informações de geolocalização e rede diretamente por meio de um cliente de IA, este repositório fornece uma interface MCP para o IP2Location.io.

IP2Location.com LITE

O IP2Location LITE fornece bancos de dados gratuitos de geolocalização de IP que os desenvolvedores podem baixar e integrar diretamente em seus aplicativos. Dependendo da edição do banco de dados, pode fornecer informações como país, região, cidade, coordenadas, CEP, fuso horário, ISP e detalhes de domínio.

Como os bancos de dados podem ser hospedados e consultados localmente, o IP2Location LITE é particularmente útil para desenvolvedores que preferem não depender de requisições externas à API. Está disponível em vários formatos e suporta dados IPv4 e IPv6.

O IP2Location LITE é um bom ponto de partida para desenvolvedores que procuram uma solução gratuita de geolocalização de IP hospedada localmente.

O que são APIs e serviços de geolocalização de IP?

Uma API de geolocalização de IP converte um endereço IPv4 ou IPv6 em informações geográficas e de rede.

Por exemplo, um aplicativo pode enviar:

8.8.8.8

e receber informações como:

• País
• Região ou estado
• Cidade
• CEP/código postal
• Latitude e longitude
• Fuso horário
• ASN
• ISP
• Domínio
• Tipo de uso de rede
• Informações de proxy

Os campos exatos dependem do serviço e do nível de assinatura.

Usos comuns de APIs de geolocalização de IP

A geolocalização de IP pode ser útil para:

• Localização de sites e aplicativos
• Seleção de conteúdo regional
• Análise de tráfego
• Solução de problemas de rede
• Investigação de segurança
• Análise de risco de fraude
• Contexto de login e autenticação
• Enriquecimento de logs de servidor
• Pesquisa de endereços IP

Este servidor MCP torna essas consultas acessíveis por meio de prompts em linguagem natural, em vez de exigir que o usuário construa manualmente requisições à API REST.

Os endereços IP podem ser rastreados?

Um endereço IP pode ser registrado ao longo do tempo por um aplicativo e enriquecido com dados de geolocalização e rede.

Por exemplo, um aplicativo de segurança pode registrar endereços IP de eventos de login e usar um serviço de inteligência de IP para identificar:

• País ou cidade aproximados
• ASN
• ISP
• Operadora de rede
• Status de proxy
• Mudanças na rede ou região geográfica

Isso pode ajudar a investigar padrões de tráfego ou atividade de rede incomum.

No entanto, a geolocalização de IP não é rastreamento preciso de pessoa ou dispositivo.

Um endereço IP pode pertencer a:

• Uma conexão residencial compartilhada
• Um gateway corporativo
• Uma operadora móvel
• Uma VPN
• Um proxy
• Um provedor de nuvem
• Um data center
• Um gateway NAT compartilhado por muitos usuários

A latitude e longitude retornadas por um serviço de geolocalização de IP são coordenadas geográficas aproximadas e não devem ser interpretadas como coordenadas GPS, endereço de rua ou prova da localização física de um indivíduo.

Este servidor MCP realiza consultas de endereços IP. Ele não monitora ou rastreia endereços IP continuamente por conta própria.

Posso usar o IP2Location.io como uma API de "meu endereço IP"?

Sim, a API REST do IP2Location.io suporta esse tipo de caso de uso.

Normalmente, um endereço IP é passado para a API:

?ip=8.8.8.8

Se o parâmetro ip for omitido de uma requisição direta à API REST do IP2Location.io, a API pode usar o endereço IP associado à requisição recebida para a consulta.

Isso é útil para aplicativos que precisam determinar informações sobre o IP público que está fazendo uma requisição à API.

Os dados típicos de "meu IP" podem incluir:

• Endereço IP público
• País
• Região
• Cidade
• Coordenadas
• CEP/código postal
• Fuso horário
• ASN

A ferramenta get_geolocation MCP neste repositório espera um endereço IP como argumento, portanto o uso do MCP é projetado principalmente para consultar um endereço IP fornecido na conversa.

Quais ferramentas são melhores para consulta de ASN e endereço IP?

A melhor ferramenta depende das informações que você precisa.

IP2Location.io

O IP2Location.io é útil quando você precisa de informações de ASN e geolocalização de IP na mesma consulta.

As informações básicas da consulta incluem:

• ASN
• Nome do Sistema Autônomo

Dados de nível superior do IP2Location.io podem incluir adicionalmente:

• Número AS
• Nome AS
• Domínio AS
• CIDR AS
• Tipo de uso AS

Por meio deste servidor MCP, você pode perguntar:

What is the ASN of 8.8.8.8?

ou:

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP e WHOIS

Os serviços RDAP e WHOIS são úteis quando você precisa de informações de registro sobre blocos de endereços IP e organizações.

Eles são particularmente úteis para identificar o registro regional da Internet associado a uma faixa de IP.

Ferramentas BGP

Os serviços de looking glass BGP e análise de roteamento são mais apropriados quando você precisa de informações sobre:

• Anúncios de rotas
• Prefixos
• Caminhos BGP
• Peering
• Mudanças de roteamento
• Qual ASN está anunciando atualmente uma rede

APIs de inteligência de IP

Os serviços de inteligência de IP são preferíveis quando um aplicativo precisa de informações estruturadas que combinam vários conjuntos de dados, como:

• Geolocalização
• ASN
• ISP
• Detecção de proxy
• Detecção de VPN
• Classificação de rede
• Dados de segurança

Para usuários de MCP que desejam informações de geolocalização e ASN no mesmo fluxo de trabalho, este projeto fornece uma interface conveniente para o IP2Location.io.

Entendendo a consulta de ASN

Um Número de Sistema Autônomo (ASN) identifica um Sistema Autônomo: uma rede ou coleção de prefixos IP operados sob uma política de roteamento comum.

Exemplos de organizações com ASNs incluem:

• Provedores de serviços de internet
• Provedores de hospedagem em nuvem
• Redes de distribuição de conteúdo
• Universidades
• Grandes empresas
• Empresas de telecomunicações

As informações de ASN podem ser úteis ao investigar um IP, pois podem revelar qual rede é responsável pelo roteamento desse endereço.

Por exemplo:

8.8.8.8

está associado a:

ASN: 15169
AS: Google LLC

A consulta de ASN é comumente usada para:

• Solução de problemas de rede
• Investigações de segurança
• Análise de tráfego
• Identificação de provedores de hospedagem
• Agrupamento de tráfego por rede
• Investigação de endereços IP suspeitos

Precisão e limitações da geolocalização de IP

A geolocalização de IP fornece uma localização geográfica estimada com base em informações de rede e alocação de IP.

Ela não deve ser tratada como a localização física exata de um usuário ou dispositivo.

A precisão pode ser afetada por:

• VPNs
• Servidores proxy
• Redes móveis
• Redes corporativas
• NAT de operadora
• Conexões via satélite
• Infraestrutura em nuvem
• Mudanças de roteamento e alocação de endereços do ISP

Os resultados em nível de país são geralmente mais confiáveis do que resultados em nível de cidade ou coordenadas exatas.

Use a geolocalização de IP como informação contextual de rede, em vez de rastreamento físico preciso.

Planos do IP2Location.io

A quantidade de informações retornadas depende do plano do IP2Location.io.

O plano gratuito fornece geolocalização básica, informações básicas de ASN e detecção básica de proxy.

Planos de nível superior podem fornecer informações adicionais, como:

• ISP
• Domínio
• Velocidade de rede
• Tipo de uso
• Informações de rede móvel
• Informações detalhadas do Sistema Autônomo
• Informações detalhadas de proxy
• Detecção de VPN
• Detecção de Tor
• Detecção de data center
• Informações de ameaças
• Pontuação de fraude
• Atributos adicionais de geolocalização

Para limites de consulta, campos e preços mais recentes, consulte:

• Preços do IP2Location.io
• Documentação da API do IP2Location.io

Recursos

• IP2Location.io
• Documentação da API do IP2Location.io
• Preços do IP2Location.io
• API de geolocalização de IP em lote do IP2Location.io

Licença

Consulte o arquivo LICENSE.TXT.