Servidor MCP de IPGeolocation.io

Servidor MCP oficial para IPGeolocation.io. Incluye 16 herramientas MCP: geolocalización IP, detección de amenazas/VPN/proxy, consultas y conversiones de zona horaria, datos de amanecer/atardecer/luna, detalles de ASN, contactos de abuso y análisis de user-agent. Siete herramientas funcionan con el plan gratuito (1.000 créditos/día). Los planes de pago desbloquean las 16 herramientas más endpoints masivos (hasta 1.000 elementos por llamada).

Funciona con Claude Desktop, Cursor, Windsurf, VS Code, Codex, Cline, Glama y cualquier otro cliente MCP.

Inicio rápido

1. Cree una clave de API gratuita de IPGeolocation

2. Los usuarios de Cursor pueden instalarlo con un solo clic:

   

3. Añada esto a la configuración de su cliente MCP (consulte Instalación por cliente más abajo para ver la ruta exacta del archivo de configuración de su cliente):

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. Reinicie su cliente.

5. Pruébelo: pregunte "¿Dónde está ubicado 8.8.8.8?"

Tabla de contenidos

• Inicio rápido

• Instalación por cliente

• Verificar que funciona

• Herramientas por plan

• Referencia de herramientas

• Ejemplos de prompts

• Ejemplos de respuestas y salida de herramientas

• Códigos de error

• Cómo funciona

• Caché

• Variables de entorno

• Compilación desde el código fuente

• Docker

• Pruebas

• Solución de problemas

• Precios

• Enlaces

• Licencia

• Política de privacidad

Instalación por cliente

Requisitos

• Node.js 18 o superior

• npx disponible en su terminal

• Una clave de API de IPGeolocation.io para la mayoría de las herramientas

get_my_ip funciona sin clave de API. Todo lo demás requiere una.

Regístrese para obtener una clave de API gratuita de IPGeolocation

Codex CLI

codex mcp add ipgeolocation --env IPGEOLOCATION_API_KEY=<YOUR_API_KEY> -- npx -y ipgeolocation-io-mcp
codex mcp list

Inicie una nueva sesión de Codex después de añadir el servidor.

Claude Desktop

Añada a claude_desktop_config.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Reinicie Claude Desktop después de guardar. También incluimos manifest.json para clientes que admiten MCP Bundles.

Cline

Abra el panel de servidores MCP > Configure > Advanced MCP Settings. Añada a cline_mcp_settings.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Reinicie Cline después de guardar.

Cursor

Instalación con un solo clic:

O añada manualmente a .cursor/mcp.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Reinicie Cursor después de guardar.

Windsurf

Añada a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Reinicie Windsurf después de guardar.

VS Code / GitHub Copilot

Añada a su settings.json de VS Code:

{
  "mcp": {
    "servers": {
      "ipgeolocation": {
        "command": "npx",
        "args": ["-y", "ipgeolocation-io-mcp"],
        "env": {
          "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
        }
      }
    }
  }
}

Reinicie VS Code después de guardar.

Glama

Puede probar el servidor directamente en Glama. Solo se requiere IPGEOLOCATION_API_KEY. Deje los otros campos de variables de entorno vacíos a menos que desee cambiar la caché, el tiempo de espera o los límites de salida.

Si aún no tiene una clave, cree una clave de API gratuita de IPGeolocation.

Cualquier otro cliente MCP

Utilice esta configuración:

{
  "command": "npx",
  "args": ["-y", "ipgeolocation-io-mcp"],
  "env": {
    "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
  }
}

Verificar que funciona

Pruebe esto después de la configuración:

Herramientas por plan

Plan gratuito

1.000 créditos por día. Estas 7 herramientas están disponibles:

Planes de pago

Las 16 herramientas. Los planes de pago también añaden campos de network, company y asn extendido a lookup_ip, además del parámetro include para security, abuse, hostname, liveHostname, hostnameFallbackLive, user_agent, geo_accuracy, dma_code o *.

Cálculo de créditos para lookup_ip con include:

Para obtener detalles actuales del plan y precios, consulte la página de precios de IPGeolocation.

Referencia de herramientas

lookup_ip

Búsqueda de una sola IP o dominio. Gratuito y de pago. 1 crédito.

Úselo cuando necesite ubicación, zona horaria, moneda o ASN para una dirección IP. En los planes de pago, puede añadir módulos include para obtener datos de seguridad, abuso o nombre de host en la misma llamada, lo que evita solicitudes adicionales.

El plan gratuito devuelve la ubicación base, metadatos del país, moneda, zona horaria y ASN básico. Los planes de pago añaden network, company, ASN extendido y el parámetro include. Tenga en cuenta que las búsquedas de dominio requieren un plan de pago.

Consejo: combinar include con fields puede reducir su coste de créditos. Por ejemplo, include=security&fields=security cuesta 2 créditos en lugar de 3 porque se omite la respuesta de geolocalización base. Del mismo modo, include=abuse&fields=abuse cuesta 1 crédito en lugar de 2.

bulk_lookup_ip

Búsqueda de IP por lotes. De pago. 1 crédito por IP.

Toma una matriz de IPs o dominios (hasta 1.000 por defecto, configurable con IPGEOLOCATION_MCP_MAX_BULK_ITEMS). Admite las mismas opciones include, fields y excludes que lookup_ip.

get_my_ip

Devuelve la IP pública de la máquina que ejecuta el servidor. Gratuito. 0 créditos. No se necesita clave de API.

No toma parámetros. Siempre accede a la red (no se almacena en caché). Útil como una comprobación rápida para confirmar que el proceso del servidor está activo.

check_security

Datos de amenaza y anonimato para una IP. De pago. 2 créditos.

Devuelve puntuación de amenaza, banderas de VPN/proxy/Tor, nombres de proveedores, puntuaciones de confianza, indicadores de bot/spam, banderas de anonimato y estado de proveedor en la nube.

Si el mismo prompt también solicita datos de ubicación, ASN o abuso, es mejor usar lookup_ip con include=security porque agrupa todo en una sola llamada (3 créditos en total en lugar de 2 + 1 por separado).

bulk_security_check

Versión por lotes de check_security. De pago. 2 créditos por IP.