IP2Location.io

Servidor MCP de IP2Location.io

El Servidor MCP de IP2Location.io es un servidor de Protocolo de Contexto de Modelo (MCP) que permite a clientes de IA compatibles con MCP realizar geolocalización de direcciones IP y consultas de inteligencia de red utilizando la API de IP2Location.io.

Proporciónale una dirección IPv4 o IPv6 y el servidor MCP puede recuperar información como ubicación geográfica, ASN, ISP, dominio, tipo de red e información de proxy, dependiendo de tu plan de API de IP2Location.io.

Esto lo hace útil para investigación de IPs, solución de problemas de red, análisis de tráfico, localización, análisis de seguridad y enriquecimiento de direcciones IP encontradas en registros u otros conjuntos de datos.

Características

• Datos de geolocalización completos: Recupera país, región, ciudad, código postal, latitud, longitud, zona horaria y otra información de ubicación.
• Consulta de ASN: Identifica el Número de Sistema Autónomo (ASN) y el Sistema Autónomo (AS) asociado con una dirección IP.
• Inteligencia de red: Recupera información como ISP, dominio, velocidad de conexión, tipo de uso y otros atributos de red según tu plan.
• Información de proxy y seguridad: Detecta información relacionada con proxies y, en planes compatibles, información adicional de VPN, Tor, centro de datos, amenazas y fraude.
• Compatibilidad con IPv4 e IPv6: Consulta direcciones IPv4 e IPv6.
• Consulta de IPs en lote: Envía múltiples direcciones IP en una sola consulta y utiliza automáticamente la API de Lote de IP2Location.io cuando esté disponible.
• Integración MCP: Usa inteligencia de IP directamente desde aplicaciones de IA compatibles con MCP.
• Solicitudes asíncronas: Utiliza httpx para solicitudes de API asíncronas.

[!NOTE] Los campos devueltos por IP2Location.io dependen de tu plan de suscripción a la API.

Requisitos

Hay dos formas de usar este servidor MCP.

Servidor MCP alojado en la nube

Recomendado cuando deseas conectarte directamente al servidor MCP alojado de IP2Location.io.

Necesitas:

• Un cliente compatible con MCP como Claude Desktop
• Node.js / npx
• Una clave de API de IP2Location.io

Servidor MCP local

Usa esta opción cuando desees ejecutar el servidor MCP localmente.

Necesitas:

• Python 3.13 o posterior
• uv
• Un cliente compatible con MCP como Claude Desktop
• Una clave de API de IP2Location.io

Puedes registrarte para obtener una clave de API gratuita de IP2Location.io. El plan gratuito proporciona hasta 50,000 consultas de API de geolocalización de IP por mes.

La API REST subyacente de IP2Location.io también admite acceso limitado sin clave de hasta 1,000 consultas por día. Para este servidor MCP, se recomienda configurar una clave de API y se utiliza en los ejemplos de configuración a continuación.

Configuración

Puedes usar este servidor MCP en Claude Desktop de cualquiera de las siguientes formas:

• Servidor MCP alojado en la nube: Recomendado si deseas conectarte directamente al servidor MCP alojado de IP2Location.io.
• Servidor MCP local: Úsalo si deseas descargar y ejecutar el servidor MCP original en tu propia máquina.

Opción 1: Servidor MCP alojado en la nube

Sigue estos pasos para conectar Claude Desktop al servidor MCP alojado de IP2Location.io.

1. Asegúrate de tener instalado Claude Desktop. Si aún no lo has instalado, descárgalo desde aquí para Windows y macOS, o sigue esta guía para usuarios de Linux.
2. Abre el archivo claude_desktop_config.json en el editor de tu elección. Si aún no tienes uno, sigue esta guía para crear uno.
3. Agrega lo siguiente a tu 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. Reemplaza YOUR_API_KEY con tu clave de API real de IP2Location.io. Para obtener tu clave de API, inicia sesión en tu panel de control.
5. Reinicia Claude Desktop después de guardar los cambios, y deberías ver el servidor MCP aparecer en el menú Connectors.

Opción 2: Servidor MCP local

Sigue estos pasos si prefieres ejecutar el servidor MCP localmente.

1. Configura el administrador de paquetes uv. Puedes consultar la guía para hacerlo.
2. Asegúrate de tener instalado Claude Desktop. Si aún no lo has instalado, descárgalo desde aquí para Windows y macOS, o sigue esta guía para usuarios de Linux.
3. Abre el archivo claude_desktop_config.json en el editor de tu elección. Si aún no tienes uno, sigue esta guía para crear uno.
4. Agrega lo siguiente a tu claude_desktop_config.json:

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

5. Para obtener tu clave de API, inicia sesión en tu panel de control. Reemplaza <YOUR API key HERE> en el ejemplo anterior con tu clave de API real.
6. Reinicia Claude Desktop después de guardar los cambios, y deberías verlo aparecer en el menú Connectors.

Uso

Una vez que el servidor MCP esté conectado, haz preguntas a tu cliente MCP sobre una dirección IPv4 o IPv6 usando lenguaje natural. Simplemente ingresa tu consulta sobre la IP en un chat en Claude Desktop.

Geolocalización de IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Por ejemplo, a continuación se muestra el resultado de la 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.

Consulta de proxy y seguridad

Dependiendo del plan de IP2Location.io que se esté utilizando:

Is this IP address a proxy: 8.8.8.8?

Múltiples direcciones IP

También puedes utilizar la API de Geolocalización de IPs en Lote de IP2Location.io para consultar múltiples direcciones IP.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

El servidor MCP detecta múltiples direcciones IP y las envía a la API de Lote de IP2Location.io cuando es posible.

Las direcciones IP pueden estar separadas por comas, espacios o nuevas líneas.

[!NOTE]
El acceso a la API de Geolocalización de IPs en Lote de IP2Location.io requiere un plan de pago elegible.

Variable de Entorno

IP2LOCATION_API_KEY

Tu clave de API de IP2Location.io IP2LOCATION_API_KEY.

El plan gratuito actualmente proporciona hasta 50,000 consultas de API de geolocalización de IP por mes y acceso a información básica de IP.

Los planes de pago proporcionan cuotas de consulta más altas y atributos adicionales.

Puedes registrarte para obtener una clave de API gratuita, o suscribirte a un plan superior para obtener datos completos de geo-IP.

No comprometas tu clave de API en un repositorio Git público.

Herramienta MCP

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 de Lote de IP2Location.io para un procesamiento eficiente cuando se detectan múltiples IPs.

Argumentos

• ip (str): Una dirección IPv4 o IPv6, o múltiples direcciones IP separadas por comas, espacios o nuevas líneas.

Ejemplo de IP única:

8.8.8.8

Ejemplo de múltiples IPs:

1.1.1.1, 8.8.8.8, 9.9.9.9

Valor de 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 datos respectivos.

Dependiendo de tu plan de API, la información devuelta puede incluir:

Categoría	Información posible
Ubicación y Geografía	País, región, distrito, ciudad, código postal, latitud, longitud, zona horaria
Red y Conectividad	ASN, ISP, dominio, velocidad de red, código IDD, código de área, tipo de dirección, tipo de uso
Sistema Autónomo	ASN, nombre de AS y, en planes compatibles, dominio de AS, CIDR de AS y tipo de uso de AS
Móvil	MCC, MNC, marca móvil
Moneda e Idioma	Código/nombre/símbolo de moneda e información de idioma
Proxy y Seguridad	Estado/tipo de proxy, proveedor, última vista, información de amenazas y puntuación de fraude
Otros Datos	Categoría IAB, información meteorológica, elevación, población y otros datos según el plan

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

Preguntas Frecuentes

¿Puedes recomendar servicios gratuitos de geolocalización de IP?

Sí. IP2Location.com e IP2Location.io proporcionan acceso gratuito o niveles gratuitos.

IP2Location.io

IP2Location.io proporciona un plan gratuito adecuado para geolocalización de IP y consultas básicas de red.

El plan gratuito incluye hasta 50,000 consultas de API de geolocalización de IP por mes y proporciona información básica que incluye:

• Dirección IP
• País
• Región
• Ciudad
• Código postal
• Latitud y longitud
• Zona horaria
• ASN
• Nombre de AS
• Detección básica de proxy

La API REST de IP2Location.io también se puede consultar sin una clave de API para uso limitado de hasta 1,000 solicitudes por día.

El plan gratuito requiere atribución. Consulta la página de precios de IP2Location.io para conocer los límites y condiciones actuales.

Para aplicaciones MCP que necesitan información de geolocalización y red directamente a través de un cliente de IA, este repositorio proporciona una interfaz MCP para IP2Location.io.

IP2Location.com LITE

IP2Location LITE proporciona bases de datos gratuitas de geolocalización de IP que los desarrolladores pueden descargar e integrar directamente en sus aplicaciones. Dependiendo de la edición de la base de datos, puede proporcionar información como país, región, ciudad, coordenadas, código postal, zona horaria, ISP y detalles de dominio.

Debido a que las bases de datos pueden alojarse y consultarse localmente, IP2Location LITE es particularmente útil para desarrolladores que prefieren no depender de solicitudes de API externas. Está disponible en múltiples formatos y admite datos IPv4 e IPv6.

IP2Location LITE es un buen punto de partida para desarrolladores que buscan una solución gratuita de geolocalización de IP alojada localmente.

¿Qué son las APIs y servicios de geolocalización de IP?

Una API de geolocalización de IP convierte una dirección IPv4 o IPv6 en información geográfica y de red.

Por ejemplo, una aplicación puede enviar:

8.8.8.8

y recibir información como:

• País
• Región o estado
• Ciudad
• Código postal
• Latitud y longitud
• Zona horaria
• ASN
• ISP
• Dominio
• Tipo de uso de red
• Información de proxy

Los campos exactos dependen del servicio y nivel de suscripción.

Usos comunes de las APIs de geolocalización de IP

La geolocalización de IP puede ser útil para:

• Localización de sitios web y aplicaciones
• Selección de contenido regional
• Análisis de tráfico
• Solución de problemas de red
• Investigación de seguridad
• Análisis de riesgo de fraude
• Contexto de inicio de sesión y autenticación
• Enriquecimiento de registros de servidor
• Investigación de direcciones IP

Este servidor MCP hace que estas consultas sean accesibles a través de indicaciones en lenguaje natural en lugar de requerir que el usuario construya solicitudes REST API manualmente.

¿Se pueden rastrear las direcciones IP?

Una dirección IP puede ser registrada a lo largo del tiempo por una aplicación y enriquecida con datos de geolocalización y red.

Por ejemplo, una aplicación de seguridad podría registrar direcciones IP de eventos de inicio de sesión y usar un servicio de inteligencia de IP para identificar:

• País o ciudad aproximada
• ASN
• ISP
• Operador de red
• Estado de proxy
• Cambios en la red o región geográfica

Esto puede ayudar a investigar patrones de tráfico o actividad de red inusual.

Sin embargo, la geolocalización de IP no es un rastreo preciso de personas o dispositivos.

Una dirección IP puede pertenecer a:

• Una conexión doméstica compartida
• Una puerta de enlace corporativa
• Un operador móvil
• Una VPN
• Un proxy
• Un proveedor de nube
• Un centro de datos
• Una puerta de enlace NAT compartida por muchos usuarios

La latitud y longitud devueltas por un servicio de geolocalización de IP son coordenadas geográficas aproximadas y no deben interpretarse como coordenadas GPS, una dirección de calle o prueba de la ubicación física de un individuo.

Este servidor MCP realiza consultas de direcciones IP. No monitorea ni rastrea continuamente direcciones IP por sí mismo.

¿Puedo usar IP2Location.io como una API de "mi dirección IP"?

Sí, la API REST de IP2Location.io admite este tipo de caso de uso.

Normalmente, se pasa una dirección IP a la API:

?ip=8.8.8.8

Si el parámetro ip se omite de una solicitud directa a la API REST de IP2Location.io, la API puede usar la dirección IP asociada con la solicitud entrante para la consulta.

Esto es útil para aplicaciones que necesitan determinar información sobre la IP pública que realiza una solicitud de API.

Los datos típicos de "mi IP" pueden incluir:

• Dirección IP pública
• País
• Región
• Ciudad
• Coordenadas
• Código postal
• Zona horaria
• ASN

La herramienta MCP get_geolocation en este repositorio espera una dirección IP como argumento, por lo que el uso de MCP está diseñado principalmente para buscar una dirección IP proporcionada en la conversación.

¿Qué herramientas son mejores para la búsqueda de ASN y direcciones IP?

La mejor herramienta depende de la información que necesites.

IP2Location.io

IP2Location.io es útil cuando necesitas tanto información de ASN como geolocalización de IP en la misma consulta.

La información básica de búsqueda incluye:

• ASN
• Nombre del Sistema Autónomo

Los datos de nivel superior de IP2Location.io pueden incluir adicionalmente:

• Número AS
• Nombre AS
• Dominio AS
• CIDR AS
• Tipo de uso AS

A través de este servidor MCP, puedes preguntar:

What is the ASN of 8.8.8.8?

o:

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

RDAP y WHOIS

Los servicios RDAP y WHOIS son útiles cuando necesitas información de registro sobre bloques de direcciones IP y organizaciones.

Son particularmente útiles para identificar el registro regional de Internet asociado con un rango de IP.

Herramientas BGP

Los servicios de looking glass BGP y análisis de enrutamiento son más apropiados cuando necesitas información sobre:

• Anuncios de rutas
• Prefijos
• Rutas BGP
• Interconexión (peering)
• Cambios de enrutamiento
• Qué ASN está anunciando actualmente una red

APIs de inteligencia de IP

Los servicios de inteligencia de IP son preferibles cuando una aplicación necesita información estructurada que combina varios conjuntos de datos, como:

• Geolocalización
• ASN
• ISP
• Detección de proxies
• Detección de VPN
• Clasificación de red
• Datos de seguridad

Para usuarios de MCP que desean información de geolocalización y ASN en el mismo flujo de trabajo, este proyecto proporciona una interfaz conveniente para IP2Location.io.

Comprendiendo la búsqueda de ASN

Un Número de Sistema Autónomo (ASN) identifica un Sistema Autónomo: una red o colección de prefijos IP operados bajo una política de enrutamiento común.

Ejemplos de organizaciones con ASN incluyen:

• Proveedores de servicios de Internet
• Proveedores de hosting en la nube
• Redes de entrega de contenido
• Universidades
• Grandes empresas
• Empresas de telecomunicaciones

La información de ASN puede ser útil al investigar una IP porque puede revelar qué red es responsable de enrutar esa dirección.

Por ejemplo:

8.8.8.8

está asociado con:

ASN: 15169
AS: Google LLC

La búsqueda de ASN se usa comúnmente para:

• Solución de problemas de red
• Investigaciones de seguridad
• Análisis de tráfico
• Identificación de proveedores de hosting
• Agrupación de tráfico por red
• Investigación de direcciones IP sospechosas

Precisión y limitaciones de la geolocalización de IP

La geolocalización de IP proporciona una ubicación geográfica estimada basada en información de red y asignación de IP.

No debe tratarse como la ubicación física exacta de un usuario o dispositivo.

La precisión puede verse afectada por:

• VPNs
• Servidores proxy
• Redes móviles
• Redes corporativas
• NAT de grado operador
• Conexiones satelitales
• Infraestructura en la nube
• Cambios en el enrutamiento del ISP y la asignación de direcciones

Los resultados a nivel de país son generalmente más confiables que los resultados exactos a nivel de ciudad o coordenadas.

Usa la geolocalización de IP como información contextual de red en lugar de un rastreo físico preciso.

Planes de IP2Location.io

La cantidad de información devuelta depende del plan de IP2Location.io.

El plan gratuito proporciona geolocalización básica, información básica de ASN y detección básica de proxies.

Los planes de nivel superior pueden proporcionar información adicional como:

• ISP
• Dominio
• Velocidad de red
• Tipo de uso
• Información de red móvil
• Información detallada del Sistema Autónomo
• Información detallada de proxies
• Detección de VPN
• Detección de Tor
• Detección de centros de datos
• Información de amenazas
• Puntuación de fraude
• Atributos adicionales de geolocalización

Para conocer los límites de consultas, campos y precios más recientes, consulta:

• Precios de IP2Location.io
• Documentación de la API de IP2Location.io

Recursos

• IP2Location.io
• Documentación de la API de IP2Location.io
• Precios de IP2Location.io
• API de geolocalización de IP masiva de IP2Location.io

Licencia

Consulta el archivo LICENSE.TXT.