IP2Location.io

Servidor MCP do IP2Location.io

O servidor MCP do IP2Location.io é um servidor do 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 do IP2Location.io.

Informe um endereço IPv4 ou IPv6, e o servidor MCP poderá 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 do IP2Location.io.

Isso o torna útil para investigação de IPs, 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 de ASN: Identifique o Número do 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, nos planos compatíveis, informações adicionais sobre VPN, Tor, data center, ameaças e fraudes.
• Suporte a IPv4 e IPv6: Consulte endereços IPv4 e IPv6.
• Consulta em lote de IPs: Envie vários endereços IP em um único prompt e use automaticamente a API em lote do IP2Location.io quando disponível.
• Integração com MCP: Use inteligência de IP diretamente em aplicativos de IA compatíveis com MCP.
• Solicitações assíncronas: Usa httpx para solicitaçõ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ê quiser se conectar diretamente ao servidor MCP hospedado do IP2Location.io.

Você pode se conectar de uma destas duas maneiras:

• Conexão HTTP direta: Seu cliente MCP é compatível com servidores MCP remotos (HTTP transmitível). Não é necessário software adicional.
• Por meio de npx: Seu cliente MCP é compatível apenas com servidores locais (stdio). Isso usa o pacote mcp-remote para fazer a ponte com o servidor hospedado.

Você precisa de:

• Um cliente compatível com MCP, como o Claude Desktop
• Uma chave de API do IP2Location.io
• Node.js / npx (somente para o método de conexão npx)

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 do IP2Location.io

Você pode se cadastrar para obter uma chave de API gratuita do IP2Location.io. O plano Free oferece até 50.000 consultas mensais à API de geolocalização de IPs.

A API REST subjacente do IP2Location.io também oferece acesso limitado sem chave, de até 1.000 consultas por dia. Para este servidor MCP, recomenda-se configurar uma chave de API, como 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 se conectar diretamente ao servidor MCP hospedado do IP2Location.io.
• Servidor MCP local: Use esta opção se quiser baixar e executar o servidor MCP original na sua própria máquina.

Opção 1: Servidor MCP hospedado na nuvem

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

1. Verifique se o Claude Desktop está instalado. Se ainda não estiver, baixe-o aqui para Windows e macOS ou siga este guia para Linux.
2. Abra o arquivo claude_desktop_config.json no editor de sua preferência. Se ainda não tiver um, siga este guia para criar um.
3. Adicione uma das configurações abaixo, dependendo de como você deseja se conectar.

Método A: Conexão HTTP direta

Use esta opção se o seu cliente MCP for compatível com servidores remotos por HTTP. Não é necessário Node.js nem npx.

{
  "mcpServers": {
    "ip2location": {
      "type": "http",
      "url": "https://mcp.ip2location.io/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Se o seu cliente for configurado pela linha de comando, como o Claude Code, você poderá adicionar o servidor com:

claude mcp add --transport http ip2location https://mcp.ip2location.io/ --header "X-API-Key: YOUR_API_KEY"

Método B: Conexão por meio de npx

Use esta opção se o seu cliente MCP for compatível apenas com servidores locais (stdio). O pacote mcp-remote é executado localmente e encaminha as solicitações ao servidor hospedado.

{
  "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 real do IP2Location.io. Para obter sua chave de API, faça login no seu painel.
5. Depois de salvar as alterações, reinicie o Claude Desktop. O servidor MCP deverá 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. Consulte o guia para saber como fazer isso.
2. Verifique se o Claude Desktop está instalado. Se ainda não estiver, baixe-o aqui para Windows e macOS ou siga este guia para Linux.
3. Abra o arquivo claude_desktop_config.json no editor de sua preferência. Se 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. Depois de salvar as alterações, reinicie o Claude Desktop. O servidor deverá aparecer no menu Connectors.

Integração com frameworks

O servidor MCP também pode ser usado com frameworks de agentes Python. Os exemplos abaixo se conectam ao servidor hospedado por HTTP. Para usar o servidor local, conecte-se com o comando stdio uvx e o argumento mcp-ip2location-io, e passe IP2LOCATION_API_KEY como variável de ambiente.

Cada exemplo lê a chave de API da variável de ambiente IP2LOCATION_API_KEY, para que ela nunca apareça no código-fonte.

LangChain

O LangChain inclui suporte a MCP no namespace langchain.mcp, que requer o LangChain 1.4 ou posterior.

pip install "langchain[mcp]" langchain-anthropic

import asyncio
import os

from fastmcp.client.transports import StreamableHttpTransport
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

async def main():
    transport = StreamableHttpTransport(
        "https://mcp.ip2location.io/",
        headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
    )

    async with MCPAdapter(transport) as adapter:
        tools = await adapter.list_tools()

        agent = create_agent("anthropic:claude-sonnet-5", tools)
        result = await agent.ainvoke({"messages": "Where is 8.8.8.8 located?"})
        print(result["messages"][-1].content)

if __name__ == "__main__":
    asyncio.run(main())

MCPAdapter aceita diretamente a URL do servidor, mas o objeto StreamableHttpTransport é passado aqui para que o cabeçalho X-API-Key possa ser definido.

LlamaIndex

pip install llama-index-tools-mcp llama-index-llms-openai

import asyncio
import os

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

async def main():
    client = BasicMCPClient(
        "https://mcp.ip2location.io/",
        headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
    )

    tools = await McpToolSpec(client=client).to_tool_list_async()

    agent = FunctionAgent(
        tools=tools,
        llm=OpenAI(model="gpt-5-mini"),
        system_prompt="You are a helpful assistant that looks up IP addresses.",
    )

    response = await agent.run("Where is 8.8.8.8 located?")
    print(response)

if __name__ == "__main__":
    asyncio.run(main())

CrewAI

O CrewAI lê os servidores MCP do campo mcps de um agente. Para isso, é necessário instalar o pacote mcp junto com o CrewAI.

pip install crewai mcp

import os

from crewai import Agent, Crew, Process, Task
from crewai.mcp import MCPServerHTTP

ip_agent = Agent(
    role="IP Intelligence Analyst",
    goal="Look up geolocation and network information for an IP address.",
    backstory="An analyst who checks IP addresses against IP2Location.io.",
    mcps=[
        MCPServerHTTP(
            url="https://mcp.ip2location.io/",
            headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
        )
    ],
)

task = Task(
    description="Find the geolocation of 8.8.8.8 and summarize the result.",
    expected_output="A short summary of the IP address location and network data.",
    agent=ip_agent,
)

crew = Crew(agents=[ip_agent], tasks=[task], process=Process.sequential)
print(crew.kickoff())

Nas versões do CrewAI que não são compatíveis com o campo mcps, instale crewai-tools[mcp] e envolva o servidor com MCPServerAdapter de crewai_tools.

Uso

Depois que o servidor MCP estiver conectado, faça perguntas ao seu cliente MCP, em linguagem natural, sobre um endereço IPv4 ou IPv6. Basta inserir 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 para o IP 8.8.8.8:

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

Consulta de proxy e segurança

Dependendo do plano do IP2Location.io utilizado:

Is this IP address a proxy: 8.8.8.8?

Vários endereços IP

Você também pode usar a API em lote de geolocalização de IPs 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 à API em lote do IP2Location.io quando possível.

Os endereços IP podem ser separados por vírgulas, espaços ou quebras de linha.

[!NOTE]
O acesso à API em lote de geolocalização de IPs do IP2Location.io requer um plano pago elegível.

Variável de ambiente

IP2LOCATION_API_KEY

Sua chave de API do IP2Location.io IP2LOCATION_API_KEY.

Atualmente, o plano Free oferece até 50.000 consultas mensais à API de geolocalização de IPs e acesso a informações básicas de IP.

Os planos pagos oferecem cotas de consultas maiores e atributos adicionais.

Você pode se cadastrar para obter uma chave de API gratuita ou assinar um plano superior para obter 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 a geolocalização do endereço IP informado ou de 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. Quando detecta vários IPs, encaminha automaticamente as solicitações à API em lote do IP2Location.io para um processamento eficiente.

Argumentos

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

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, será retornado um objeto JSON em que cada chave é um endereço IP associado aos 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 da rede, código IDD, código de área, tipo de endereço, tipo de uso
Sistema Autônomo	ASN, nome do AS e, nos planos compatíveis, domínio do AS, CIDR do AS e tipo de uso do AS
Dispositivos móveis	MCC, MNC, marca do dispositivo móvel
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 detecção, informações sobre ameaças e pontuação de fraude
Outros dados	Categoria IAB, informações meteorológicas, elevação, população e outros dados que dependem do plano

Se uma solicitação para um único IP falhar ou o IP for inválido, a ferramenta retornará uma mensagem de erro como string. Em solicitações em lote, cada IP que falhar retornará um objeto de erro associado ao endereço IP correspondente, sem interromper o lote inteiro.

Perguntas frequentes

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

Sim. IP2Location.com e IP2Location.io oferecem acesso gratuito ou planos gratuitos.

IP2Location.io

O IP2Location.io oferece um plano Free adequado para geolocalização de IPs e consultas básicas de rede.

O plano Free inclui até 50.000 consultas mensais à API de geolocalização de IPs 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 uma chave de API, com uso limitado a até 1.000 solicitações por dia.

O plano Free exige atribuição. Consulte a página de preços do IP2Location.io para ver os limites e as 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 oferece uma interface MCP para o IP2Location.io.

IP2Location.com LITE

IP2Location LITE oferece bancos de dados gratuitos de geolocalização de IP que os desenvolvedores podem baixar e integrar diretamente aos seus aplicativos. Dependendo da edição do banco de dados, ele 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 solicitações a APIs externas. Está disponível em vários formatos e oferece suporte a 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 da rede
• Informações de proxy

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

Usos comuns das APIs de geolocalização de IP

A geolocalização por 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 do servidor
• Pesquisa de endereços IP

Este servidor MCP disponibiliza essas consultas por meio de prompts em linguagem natural, sem exigir que o usuário crie manualmente solicitações à API REST.

É possível rastrear endereços IP?

Um aplicativo pode registrar um endereço IP ao longo do tempo e enriquecê-lo com dados de geolocalização e de 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
• Alterações na rede ou na região geográfica

Isso pode ajudar a investigar padrões de tráfego ou atividades de rede incomuns.

No entanto, a geolocalização por IP não permite rastrear com precisão uma pessoa ou um dispositivo.

Um endereço IP pode pertencer a:

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

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

Este servidor MCP realiza consultas de endereços IP. Ele não monitora nem 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 oferece suporte a esse tipo 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 solicitação direta à API REST do IP2Location.io, a API poderá usar o endereço IP associado à solicitação recebida para fazer a consulta.

Isso é útil para aplicativos que precisam determinar informações sobre o IP público que faz uma solicitaçã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 MCP get_geolocation deste repositório espera um endereço IP como argumento; portanto, o uso via MCP foi projetado principalmente para consultar um endereço IP fornecido na conversa.

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

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

IP2Location.io

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

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

• ASN
• Nome do Sistema Autônomo

Os planos superiores do IP2Location.io também podem incluir:

• Número do AS
• Nome do AS
• Domínio do AS
• CIDR do AS
• Tipo de uso do 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 do Registro Regional da Internet associado a um intervalo de IPs.

Ferramentas BGP

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

• Anúncios de rotas
• Prefixos
• Caminhos BGP
• Peering
• Alterações de roteamento
• Qual ASN está anunciando uma rede no momento

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 combinem 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 oferece uma interface prática 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 conjunto de prefixos IP operado sob uma política de roteamento comum.

Exemplos de organizações que possuem ASNs:

• 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 por IP

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

Ela não deve ser considerada 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 nível de operadora
• Conexões via satélite
• Infraestrutura de nuvem
• Alterações no roteamento e na alocação de endereços do ISP

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

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

Planos do IP2Location.io

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

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

Os planos superiores podem fornecer informações adicionais, como:

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

Para consultar os limites de consultas, campos e preços mais recentes, acesse:

• 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 em massa de IPs do IP2Location.io

Licença

Consulte o arquivo LICENSE.TXT.