Servidor MCP de IP2Location.io

Esta es una implementación sencilla de servidor del Protocolo de Contexto de Modelo (MCP) para la API de IP2Location.io. Devolverá información detallada de geolocalización para cualquier dirección IPv4 o IPv6 proporcionada.

Características

• Datos de geolocalización completos: Recupera una amplia gama de información, incluyendo país, región, ciudad, latitud, longitud, código postal, zona horaria y más.

• Detalles de red: Proporciona datos relacionados con la red, como ASN, ISP, dominio y velocidad de red.

• Información de seguridad: Detecta información de proxy, incluyendo el tipo de proxy y el proveedor.

• Integración sencilla: Creado como una herramienta FastMCP, lo que permite una fácil integración en sistemas compatibles.

• Asíncrono: Utiliza httpx para solicitudes de API asíncronas no bloqueantes.

Requisitos

Este servidor MCP permite realizar consultas sin una clave de API, con una limitación de 1.000 consultas por día. También puede registrarse para obtener una clave de API gratuita y disfrutar de hasta 50.000 consultas al mes.

La configuración también utiliza uv, que se puede instalar siguiendo la guía.

Configuración

Siga los pasos para utilizar este servidor MCP con Claude Desktop:

1. Descargue el repositorio en su equipo local.

2. Configure el gestor de paquetes uv; puede consultar de nuevo la guía para hacerlo.

3. Asegúrese de haber instalado Claude Desktop; si no lo ha hecho, descárguelo desde aquí para usuarios de Windows y MacOS, o siga esta guía para usuarios de Linux.

4. Abra el archivo claude_desktop_config.json en el editor de su elección; si aún no tiene uno, siga esta guía para crear uno.

5. Añada lo siguiente a su claude_desktop_config.json:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ip2locationio/src",
        "run",
        "server.py"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

6. Recuerde reemplazar la ruta /path/to/ip2locationio con su ruta real al servidor MCP de IP2Location.io en su equipo local.

7. Para obtener su clave de API, simplemente inicie sesión en su panel de control y obténgala desde allí. Reemplace <YOUR API key HERE> en el texto anterior con su clave de API real.

8. Reinicie Claude Desktop después de guardar los cambios y debería verlo aparecer en el menú Connectors.

Uso

Simplemente introduzca su consulta sobre la IP en un chat en Claude Desktop. Algunos ejemplos de consultas serían:

• ¿Cuál es la ubicación de (IP)?

• ¿Dónde se encuentra (IP)?

• ¿Cuáles son las coordenadas de (IP)?

Por ejemplo, a continuación se muestra el resultado para la IP 8.8.8.8:

En Claude Desktop, el modelo generará automáticamente el resultado basado en la información devuelta por el servidor MCP de IP2Location.io.

También puede utilizar la API de geolocalización IP masiva de IP2Location.io para consultar múltiples direcciones IP. Simplemente introduzca todas las direcciones IP con un espacio entre cada una. Por ejemplo 8.8.8.8 8.8.6.6.

[!NOTE] La API de geolocalización IP masiva de IP2Location.io requiere un plan de pago para funcionar.

Variable de entorno

IP2LOCATION_API_KEY

La clave de API de IP2Location.io, que le permite realizar hasta 50.000 consultas al mes y obtener más detalles de la dirección IP. Puede registrarse para obtener una clave de API gratuita o suscribirse a un plan para disfrutar de más beneficios.

Herramienta

get_geolocation

Descripción Obtiene la geolocalización para la dirección IP proporcionada o un lote de direcciones IP. Ayuda a los usuarios a recuperar información detallada como país, región, ciudad, latitud, longitud, código postal, zona horaria, ASN e información de proxy para cualquier dirección IPv4 o IPv6. Dirige automáticamente las solicitudes a la API masiva de IP2Location.io para un procesamiento eficiente cuando se detectan múltiples IPs.

Argumentos

• ip (str): La dirección IP (IPv4 o IPv6) a analizar. Puede consultar múltiples IPs a la vez pasándolas como una sola cadena separada por comas, espacios o saltos de línea (p. ej., "1.1.1.1, 2.2.2.2").

Retorno Una cadena JSON que contiene los datos de geolocalización. Si se consultan múltiples IPs, devuelve un objeto JSON donde cada clave es una dirección IP asignada a sus respectivos datos. El resultado puede incluir los siguientes campos, dependiendo de su plan de API:

• Ubicación y geografía: País, región, distrito, ciudad, código postal, latitud y longitud, zona horaria.

• Red y conectividad: ASN (Número de Sistema Autónomo), ISP (Proveedor de Servicios de Internet), dominio, velocidad de red, código IDD, código de área, tipo de dirección, tipo de uso.

• Información móvil: MNC (Código de Red Móvil), MCC (Código de País Móvil), Marca móvil.

• Moneda e idioma: código de moneda, nombre de moneda, símbolo de moneda, código de idioma, nombre de idioma.

• Proxy y seguridad: tipo de proxy, última vez visto, nivel/tipo de amenaza, proveedor de proxy, puntuación de fraude.

• Otros: categoría IAB, clima, elevación, población y más.

Si una solicitud de una sola IP falla o la IP no es válida, la herramienta devuelve un mensaje de error como cadena. Para solicitudes masivas, cualquier IP individual que falle devolverá un objeto de error asignado a esa dirección IP específica sin hacer que falle todo el lote.

Licencia

Consulte el archivo LICENSE.