IP2Location.io MCP Server

oficial

Integración con la API de IP2Location.io para obtener información de geolocalización de una dirección IP.

GitHub
13

Documentación

Servidor MCP de IP2Location.io

Esta es una implementación simple 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.

mcp-ip2location-io MCP server

Trust Score

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 Simple: Construido como una herramienta FastMCP, lo que permite una fácil integración en sistemas compatibles.
  • Asíncrono: Utiliza httpx para solicitudes API asíncronas sin bloqueo.

Requisito

Este servidor MCP admite consultas sin una clave API, con una limitación de 1,000 consultas por día. También puede registrarse para obtener una clave API gratuita y disfrutar de hasta 50,000 consultas por mes.

Si utiliza el servidor MCP alojado en la nube, solo necesita Claude Desktop y npx, porque el servidor está alojado de forma remota. Si desea ejecutar el servidor MCP original localmente, la configuración local utiliza uv, que se puede instalar siguiendo la guía.

Configuración

Puede usar este servidor MCP en Claude Desktop de cualquiera de las siguientes maneras:

  • Servidor MCP alojado en la nube: Recomendado si desea conectarse directamente al servidor MCP de IP2Location.io alojado.
  • Servidor MCP local: Úselo si desea descargar y ejecutar el servidor MCP original en su propia máquina.

Opción 1: Servidor MCP alojado en la nube

Siga los pasos a continuación para usar el servidor MCP de IP2Location.io alojado en la nube con Claude Desktop:

  1. Asegúrese de tener instalado Claude Desktop. Si aún no lo ha instalado, descárguelo desde aquí para Windows y macOS, o siga esta guía para usuarios de Linux.
  2. 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.
  3. Agregue lo siguiente a su claude_desktop_config.json:
{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. Reemplace YOUR_API_KEY con su clave API real de IP2Location.io. Para obtener su clave API, inicie sesión en su panel de control.
  2. Reinicie Claude Desktop después de guardar los cambios, y debería ver el servidor MCP aparecer en el menú Connectors.

Opción 2: Servidor MCP local

Siga los pasos a continuación si desea ejecutar el servidor MCP original localmente con Claude Desktop:

  1. Configure el gestor de paquetes uv. Puede consultar la guía para hacerlo.
  2. Asegúrese de tener instalado Claude Desktop. Si aún no lo ha instalado, descárguelo desde aquí para Windows y macOS, o siga esta guía para usuarios de Linux.
  3. 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.
  4. Agregue lo siguiente a su claude_desktop_config.json:
{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}
  1. Para obtener su clave API, inicie sesión en su panel de control. Reemplace <YOUR API key HERE> en el ejemplo anterior con su clave API real.
  2. Reinicie Claude Desktop después de guardar los cambios, y debería verlo aparecer en el menú Connectors.

Uso

Simplemente ingrese su consulta sobre la IP en un chat en Claude Desktop. Algunos ejemplos de consulta serán:

  • ¿Dónde está la ubicación de (IP)?
  • ¿Dónde se encuentra (IP)?
  • ¿Cuál es la coordenada de (IP)?

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

The output of the IP 8.8.8.8

En Claude Desktop, el modelo generará automáticamente la salida basada en el resultado devuelto por el servidor MCP de IP2Location.io.

También puede utilizar la API de Geolocalización IP por Lotes de IP2Location.io para consultar múltiples direcciones IP. Simplemente ingrese todas las direcciones IP con un espacio entre cada dirección IP. Por ejemplo 8.8.8.8 8.8.6.6.

[!NOTE]
La API de Geolocalización IP por Lotes de IP2Location.io requiere un plan de pago para funcionar.

Variable de Entorno

IP2LOCATION_API_KEY

La clave API de IP2Location.io, que le permite consultar hasta 50,000 por mes y obtener más detalles de la dirección IP. Puede registrarse para obtener una clave 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 dada 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. Enruta automáticamente las solicitudes a la API por Lotes 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 nuevas líneas (por ejemplo, "1.1.1.1, 2.2.2.2").

Devuelve 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 mapeada a sus datos respectivos. 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, último 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 IP única falla o la IP no es válida, la herramienta devuelve un mensaje de error como una cadena. Para solicitudes por lotes, cualquier IP individual que falle devolverá un objeto de error mapeado a esa dirección IP específica sin que falle todo el lote.

Licencia

Consulte el archivo LICENSE.