IP2Location.io MCP Server

oficial

Integração com a API IP2Location.io para obter informações de geolocalização de um endereço IP.

Documentação

Servidor MCP IP2Location.io

Esta é uma implementação simples de servidor Model Context Protocol (MCP) para a API IP2Location.io. Ela retornará informações detalhadas de geolocalização para qualquer endereço IPv4 ou IPv6 fornecido.

Funcionalidades

Dados Abrangentes de Geolocalização: Recupera uma ampla gama de informações, incluindo país, região, cidade, latitude, longitude, código postal, fuso horário e muito mais.
Detalhes de Rede: Fornece dados relacionados à rede, como ASN, ISP, domínio e velocidade da rede.
Informações de Segurança: Detecta informações de proxy, incluindo tipo e provedor de proxy.
Integração Simples: Construído como uma ferramenta FastMCP, permitindo fácil integração em sistemas compatíveis.
Assíncrono: Utiliza httpx para requisições de API assíncronas e não bloqueantes.

Requisito

Este servidor MCP suporta consultas sem uma chave de API, com uma limitação de 1.000 consultas por dia. Você também pode cadastrar-se para obter uma chave de API gratuita e desfrutar de até 50.000 consultas por mês.

Se você usar o servidor MCP hospedado na nuvem, precisará apenas do Claude Desktop e npx, pois o servidor está hospedado remotamente. Se quiser executar o servidor MCP original localmente, a configuração local usa uv, que pode ser instalado seguindo o guia.

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 os passos abaixo para usar o servidor MCP IP2Location.io hospedado na nuvem com o Claude Desktop:

Certifique-se de ter instalado o Claude Desktop. Se ainda não o instalou, faça o download aqui para Windows e macOS, ou siga este guia para usuários Linux.
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.
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"
      ]
    }
  }
}

Substitua YOUR_API_KEY pela sua chave de API IP2Location.io real. Para obter sua chave de API, faça login no seu painel.
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 os passos abaixo se quiser executar o servidor MCP original localmente com o Claude Desktop:

Configure o gerenciador de pacotes uv. Você pode consultar o guia para fazer isso.
Certifique-se de ter instalado o Claude Desktop. Se ainda não o instalou, faça o download aqui para Windows e macOS, ou siga este guia para usuários Linux.
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.
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>"
      }
    }
  }
}

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.
Reinicie o Claude Desktop após salvar as alterações e você deverá vê-lo aparecer no menu Connectors.

Uso

Basta inserir sua consulta sobre o IP em um chat no Claude Desktop. Alguns exemplos de consulta serão:

Onde fica a localização de (IP)?
Onde está localizado (IP)?
Qual é a coordenada de (IP)?

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

The output of the 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.

Você também pode utilizar a API de Geolocalização de IP em Lote IP2Location.io para consultar vários endereços IP. Basta inserir todos os endereços IP com um espaço entre cada endereço IP. Por exemplo 8.8.8.8 8.8.6.6.

[!NOTE]
A API de Geolocalização de IP em Lote IP2Location.io requer um plano pago para funcionar.

Variável de Ambiente

IP2LOCATION_API_KEY

A chave de API IP2Location.io, que permite consultar até 50.000 por mês e obter mais detalhes do endereço IP. Você pode cadastrar-se para obter uma chave de API gratuita ou assinar um plano para desfrutar de mais benefícios.

Ferramenta

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, código postal, fuso horário, ASN e informações de proxy para qualquer endereço IPv4 ou IPv6. Ele roteia automaticamente as solicitações para a API em Lote IP2Location.io para processamento eficiente quando vários IPs são detectados.

Argumentos

ip (str): O endereço IP (IPv4 ou IPv6) a ser analisado. Você pode consultar vários IPs de uma vez, passando-os como uma única string separada por vírgulas, espaços ou novas linhas (por exemplo, "1.1.1.1, 2.2.2.2").

Retorna 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. O resultado pode incluir os seguintes campos, dependendo do seu plano de API:

Localização e Geografia: País, região, distrito, cidade, código postal, latitude e longitude, fuso horário.
Rede e Conectividade: ASN (Número de Sistema Autônomo), ISP (Provedor de Serviços de Internet), domínio, velocidade da rede, código IDD, código de área, tipo de endereço, tipo de uso.
Informações Móveis: MNC (Código de Rede Móvel), MCC (Código de País Móvel), Marca Móvel.
Moeda e Idioma: código da moeda, nome da moeda, símbolo da moeda, código do idioma, nome do idioma.
Proxy e Segurança: tipo de proxy, último visto, nível/tipo de ameaça, provedor de proxy, pontuação de fraude.
Outros: Categoria IAB, clima, elevação, população e muito mais.

Se uma solicitação de IP único falhar ou o IP for inválido, a ferramenta retorna uma mensagem de erro como uma string. Para solicitações em lote, quaisquer IPs individuais com falha retornarão um objeto de erro mapeado para aquele endereço IP específico, sem falhar todo o lote.

Licença

Consulte o arquivo LICENSE.