Globalping

oficial

Acceso a la red con la capacidad de ejecutar comandos como ping, traceroute, mtr, http, resolución de DNS.

GitHub

¿Qué puedes hacer con Globalping MCP?

Ejecutar pruebas de ping desde sondas globales — Pídele al asistente que haga ping a un objetivo desde regiones, países o ciudades específicas usando ping.
Trazar rutas de red con traceroute o MTR — Solicita un traceroute o mtr para visualizar la ruta que toman los paquetes desde ubicaciones de sondas globales.
Consultar registros DNS desde cualquier ubicación — Usa dns para resolver un dominio con resolvedores personalizados (ej., Google DNS) desde sondas en todo el mundo.
Verificar la accesibilidad HTTP y los tiempos de respuesta — Ejecuta una prueba http contra una URL para medir códigos de estado, tiempos y encabezados desde diferentes regiones.
Comparar el rendimiento de la red entre ubicaciones — Usa la guía compareLocations para realizar mediciones paralelas y contrastar la latencia o el enrutamiento entre objetivos.
Recuperar mediciones anteriores y verificar límites de tasa — Obtén un resultado previo por ID con getMeasurement o consulta los límites actuales de la API mediante limits.

Documentación

Servidor MCP de Globalping

Permite que los modelos de IA interactúen con una plataforma global de medición de redes mediante lenguaje natural. Otorga acceso de red a cualquier LLM.

¿Qué es Globalping?

Globalping es una API pública y gratuita que proporciona acceso a una red de sondas distribuidas globalmente para monitorizar, depurar y evaluar la infraestructura de internet. Con Globalping, puedes ejecutar pruebas de red (ping, traceroute, DNS, MTR, HTTP) desde miles de ubicaciones en todo el mundo.

¿Qué es el Servidor MCP de Globalping?

El Servidor MCP de Globalping implementa el Protocolo de Contexto de Modelo (MCP), permitiendo que modelos de IA como GPT de OpenAI y Claude de Anthropic interactúen con las capacidades de medición de red de Globalping mediante lenguaje natural.

También admite dos métodos de autenticación: OAuth y autenticación por token de API. Ambos métodos ofrecen una forma segura de interactuar con nuestra API y proporcionan límites de tasa más altos asociados a tu cuenta.

Características Principales

🌐 Acceso a Red Global: Ejecuta mediciones desde miles de sondas en todo el mundo
🤖 Interfaz Amigable para IA: Cualquier LLM analizará fácilmente los datos y ejecutará nuevas mediciones según sea necesario
📊 Mediciones Completas: Soporte para pruebas de ping, traceroute, DNS, MTR y HTTP
🔍 Manejo Inteligente de Contexto: Proporciona descripciones detalladas de parámetros para que los clientes de IA seleccionen inteligentemente tipos de medición y opciones
🔄 Análisis Comparativo: Permite comparar el rendimiento de red entre diferentes objetivos
🔑 Soporte de Autenticación: Usa OAuth o token de API con tu cuenta de Globalping para límites de tasa más altos

Instalación

El servidor MCP remoto está disponible en estos endpoints:

Transporte HTTP transmitible: https://mcp.globalping.dev/mcp
Transporte SSE: https://mcp.globalping.dev/sse

Puedes integrar nuestro servidor MCP de Globalping con varias herramientas de IA que soporten el Protocolo de Contexto de Modelo.

Aquí tienes instrucciones para las 3 herramientas más populares:

Gemini CLI

Para añadir el servidor MCP de Globalping a Gemini CLI:

Asegúrate de tener instalado Gemini CLI.
Ejecuta el siguiente comando:

gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

Esto configurará automáticamente el servidor con la autenticación OAuth habilitada. Se te pedirá que inicies sesión la primera vez que uses la extensión.

Nota: Si prefieres usar un token de API de Globalping (para límites de tasa más altos o automatización), puedes añadir manualmente el servidor con la cabecera Authorization en lugar de usar el instalador de extensiones:

gemini mcp add globalping https://mcp.globalping.dev/mcp --header "Authorization: Bearer YOUR_TOKEN"

Aplicación de Escritorio Claude

Añade a tu archivo de configuración de Claude Desktop (ubicado en %APPDATA%\Claude\config.json en Windows o ~/Library/Application Support/Claude/config.json en macOS):

[!note] Claude Desktop soporta de forma nativa solo el transporte stdio para servidores MCP locales. Para servidores MCP remotos, usa el puente mcp-remote.

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}

API de Anthropic Claude (vía Consola)

Al crear un Asistente Claude en la Consola de Anthropic:

Ve a console.anthropic.com
Navega a la sección de Asistentes
Crea un nuevo Asistente o edita uno existente
En la sección Herramientas, selecciona "Añadir herramienta personalizada"
Introduce los siguientes detalles:
- Nombre de la Herramienta: Globalping
- Descripción: Run network tests from locations worldwide
- URL de la Herramienta: https://mcp.globalping.dev/mcp (transporte HTTP transmitible) o https://mcp.globalping.dev/sse (transporte SSE)

Cursor

Para añadir el servidor MCP de Globalping a Cursor:

Abre la configuración de Cursor
Navega a la pestaña Herramientas y MCP
Haz clic en "+ Nuevo servidor MCP"
Esto abre el archivo de configuración mcp.json, donde necesitarás añadir:

Transporte HTTP transmitible:

{
    "mcpServers": {
        "globalping": {
            "url": "https://mcp.globalping.dev/mcp"
        }
    }
}

Transporte SSE legacy:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}

Guarda y reinicia Cursor

Autenticación

El servidor MCP de Globalping soporta dos métodos de autenticación:

Autenticación OAuth: Manejada automáticamente por el servidor para un acceso seguro
Autenticación por Token de API: Configuración manual del token mediante la cabecera Authorization

Ambos métodos proporcionan límites de tasa más altos y acceso prioritario a la red de sondas.

Usar Token de API de Globalping

El servidor detecta automáticamente cuando se proporciona un token de API en la cabecera Authorization y lo usa para la autenticación en lugar de OAuth.

Obtener tu Token de API

Visita dash.globalping.io
Inicia sesión en tu cuenta
Navega a Tokens para generar un nuevo token de API

Configuración con Autenticación

Transporte HTTP transmitible:

{
    "mcpServers": {
        "globalping": {
            "url": "https://mcp.globalping.dev/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_GLOBALPING_API_TOKEN"
            }
        }
    }
}

Transporte SSE legacy:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse",
                "--header",
                "Authorization: Bearer YOUR_GLOBALPING_API_TOKEN"
            ]
        }
    }
}

Conectar Asistentes de IA

Puedes usar nuestro servidor MCP con cualquier asistente de IA compatible con MCP, incluyendo:

Claude Desktop
Asistentes de Anthropic
Cursor
Windsurf
Cualquier implementación personalizada del protocolo MCP

Consulta la documentación MCP de tu herramienta para detalles sobre cómo conectar clientes a este servidor.

Herramientas Disponibles

ping - Realizar una prueba de ping a un objetivo
traceroute - Realizar una prueba de traceroute a un objetivo
dns - Realizar una consulta DNS para un dominio
mtr - Realizar una prueba MTR (My Traceroute) a un objetivo
http - Realizar una solicitud HTTP a una URL
locations - Listar todas las ubicaciones de sondas de Globalping disponibles
limits - Mostrar tus límites de tasa actuales para la API de Globalping
getMeasurement - Recuperar una medición ejecutada previamente por ID
compareLocations - Guía sobre cómo ejecutar mediciones comparativas
help - Mostrar un mensaje de ayuda con documentación sobre las herramientas disponibles

Ejemplos de Uso

Una vez conectado a un modelo de IA a través de un cliente MCP compatible, puedes interactuar con Globalping usando lenguaje natural:

Ping google.com from 3 locations in Europe

Run a traceroute to github.com from Japan and compare with traceroute from the US

Check the DNS resolution of example.com using Google DNS (8.8.8.8)

Is jsdelivr.com reachable from China? Test with both ping and HTTP

What's the average response time for cloudflare.com across different continents?

Especificación de Ubicación

Las ubicaciones pueden especificarse usando el campo "magic", que soporta varios formatos:

Códigos de continente: "EU", "NA", "AS", etc.
Códigos de país: "US", "DE", "JP", etc.
Nombres de ciudad: "London", "Tokyo", "New York", etc.
Nombres de red: "Cloudflare", "Google", etc.
Números ASN: "AS13335", "AS15169", etc.
Regiones de proveedor cloud: "aws-us-east-1", "gcp-us-central1", etc.

También puedes combinarlos con un signo más para una orientación más específica: "London+UK", "Cloudflare+US", etc.

Desarrollo

El código está organizado en módulos:

src/index.ts - Punto de entrada principal y definición del agente MCP
src/app.ts - Rutas web OAuth
src/api - Cliente de la API de Globalping
src/auth - Utilidades de autenticación
src/config - Configuración y constantes
src/lib - Funciones de utilidad
src/mcp - Manejadores de herramientas MCP
src/types - Definiciones de tipos TypeScript
src/ui - Plantillas HTML

Añadir credenciales de Globalping

Añade credenciales OAuth de Globalping:

npx wrangler secret put GLOBALPING_CLIENT_ID

Almacenamiento KV

Usado para OAuthProvider docs https://github.com/cloudflare/workers-oauth-provider

crea un espacio de nombres KV y copia el ID
el binding para este debe ser OAUTH_KV
configura kv_namespaces en el archivo wrangler.jsonc