Globalping

Servidor MCP de Globalping

Permite que los modelos de IA interactúen con una plataforma global de medición de redes mediante lenguaje natural. Dale acceso a la 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 monitorear, depurar y comparar el rendimiento de 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 los modelos de IA y asistentes de IDE interactúen con las capacidades de medición de red de Globalping mediante lenguaje natural.

El servidor admite autenticación estándar OAuth 2.0, así como autenticación mediante token de API para flujos de trabajo automatizados.

Características principales

• 🌐 Acceso a Red Global: Ejecuta mediciones desde miles de sondas en todo el mundo
• 🤖 Interfaz Amigable para IA: Cualquier LLM podrá analizar fácilmente los datos y ejecutar nuevas mediciones según sea necesario
• 📊 Mediciones Integrales: Soporte para pruebas de ping, traceroute, DNS, MTR y HTTP
• 🔍 Manejo Inteligente de Contexto: Descripciones detalladas de parámetros y anotaciones semánticas de herramientas para el enrutamiento inteligente de agentes
• 🔄 Análisis Comparativo: Compara la latencia de red y el enrutamiento entre diferentes objetivos y ubicaciones geográficas
• 🔑 Soporte de Autenticación: Usa OAuth o un token de API con tu cuenta de Globalping para límites de velocidad más altos

---

Instalación

El endpoint principal para todas las integraciones MCP modernas es:

https://mcp.globalping.dev/mcp HTTP Streamable

ChatGPT y Codex

Conecta Globalping como un servidor MCP remoto en ChatGPT y Codex:

ChatGPT (Web y Escritorio)

1. En ChatGPT, ve a Configuración → Seguridad e inicio de sesión y habilita el Modo desarrollador (o Configuración → Funciones → Servidores MCP en ChatGPT Escritorio).
2. Agrega un nuevo conector personalizado / servidor MCP con el endpoint:

https://mcp.globalping.dev/mcp

3. Autentícate mediante OAuth cuando se te solicite.

OpenAI Codex

Agrega el servidor remoto usando la CLI de Codex:

codex mcp add globalping --url https://mcp.globalping.dev/mcp

O agrégalo a ~/.codex/config.toml directamente:

[mcp_servers.globalping]
url = "https://mcp.globalping.dev/mcp"

Claude (Web, Escritorio)

Claude admite conectores MCP HTTP Streamable remotos de forma nativa sin requerir puentes locales de mcp-remote:

1. En Claude, navega a Configuración → Conectores (o Configuración de organización → Conectores para cuentas de Equipo/Empresa).
2. Haz clic en + Agregar conector personalizado.
3. Completa los detalles del conector:

• Nombre: Globalping
• URL: https://mcp.globalping.dev/mcp

Claude Code

Ejecuta el siguiente comando en tu terminal:

claude mcp add --transport http globalping https://mcp.globalping.dev/mcp

Para que Globalping esté disponible en todos los proyectos de tu máquina (ámbito global de usuario) en lugar de solo en el directorio del proyecto actual:

claude mcp add -s user --transport http globalping https://mcp.globalping.dev/mcp

Ejecuta claude mcp login globalping --no-browser si trabajas a través de SSH o en una terminal sin interfaz gráfica para completar el intercambio de la URL de autorización manualmente.

Cursor

Agrega Globalping a Cursor con un solo clic:

O configúralo manualmente en Configuración → Funciones → Servidores MCP → Agregar nuevo servidor MCP:

• Tipo: SSE / HTTP
• Nombre: globalping
• URL: https://mcp.globalping.dev/mcp

CLI de Gemini

Globalping está indexado en la Galería de Extensiones de Gemini CLI oficial.

Instálalo a través del administrador de extensiones de Gemini:

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

(Agrega --auto-update para mantener la extensión actualizada automáticamente).

VS Code y GitHub Copilot

• Paleta de comandos: Ejecuta MCP: Add Server e ingresa https://mcp.globalping.dev/mcp.

Clientes MCP Genéricos

Para cualquier cliente que admita el transporte MCP HTTP Streamable estándar, agrega:

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

Clientes heredados (SSE / respaldo stdio): Si tu cliente requiere estrictamente SSE a través de un puente de proceso local, configura npx mcp-remote https://mcp.globalping.dev/sse.

---

Autenticación

Globalping MCP admite dos modos de autenticación:

• OAuth 2.0: Se maneja automáticamente en clientes interactivos durante la conexión.
• Token de API: Útil para scripts sin interfaz gráfica, pipelines de CI/CD o clientes de API programáticos.

Uso de un Token de API de Globalping

1. Ve a dash.globalping.io y genera un token de API en Tokens.
2. Pasa el token mediante encabezados HTTP estándar:

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

---

Integración Programática (API de Mensajes de Anthropic)

Para usar Globalping directamente con la API de Mensajes de Anthropic (Conector MCP), pasa la definición del servidor remoto en tu carga útil de solicitud:

{
  "model": "claude-3-7-sonnet-latest",
  "max_tokens": 1024,
  "mcp_servers": [
    {
      "type": "url",
      "name": "globalping",
      "url": "https://mcp.globalping.dev/mcp"
    }
  ],
  "tools": [
    {
      "type": "mcp_toolset",
      "mcp_server_name": "globalping"
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "Run a traceroute to 1.1.1.1 from Frankfurt and Tokyo."
    }
  ]
}

---

Herramientas Disponibles

Herramienta	Descripción
ping	Realiza pruebas de ping ICMP/paquetes a un destino
traceroute	Traza los saltos de enrutamiento de red hacia un objetivo
dns	Resuelve consultas DNS usando resolvers y tipos de registro específicos
mtr	Ejecuta pruebas combinadas de ping y traceroute (My Traceroute)
http	Ejecuta solicitudes HTTP/HTTPS desde sondas en todo el mundo
locations	Lista las regiones de sondas y filtros disponibles de Globalping
limits	Muestra la asignación horaria gratuita actual de pruebas y créditos adicionales
getMeasurement	Recupera los resultados de una medición histórica por ID
compareLocations	Guía de ayuda para comparar métricas de rendimiento en múltiples regiones
help	Referencia de herramientas y documentación de sintaxis
authStatus	Verifica el estado actual de autenticación de MCP

---

Ejemplos de Uso

Una vez conectado, ejecuta diagnósticos de red 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 se pueden especificar usando el parámetro magic de la ubicación:

• Continentes: EU, NA, AS, AF, OC, SA
• Códigos de país: US, DE, JP, PL, BR
• Ciudades: London, Tokyo, New York, Warsaw
• Redes y ASN: Cloudflare, Google, AS13335, AS15169
• Regiones de nube: aws-us-east-1, gcp-us-central1
• Combinaciones: London+UK, Cloudflare+US, AWS+Frankfurt

---

Solución de Problemas y Soporte

El conector no puede alcanzar el servidor

• Usa el endpoint HTTP Streamable exactamente como se muestra: https://mcp.globalping.dev/mcp.
• Una respuesta 401 Unauthorized antes de completar OAuth es esperada. Reconecta la integración y finaliza el flujo de autorización en el navegador.
• Usa el endpoint heredado /sse solo para clientes que no admiten HTTP Streamable.

La autenticación falla o expira

• Elimina y reconecta la integración para iniciar un nuevo flujo de OAuth.
• Para la autenticación con token de API, genera un token actual en el panel de Globalping y envíalo como Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
• Una vez conectado, usa la herramienta authStatus para verificar que la autenticación esté activa y la herramienta limits para verificar la asignación horaria gratuita de pruebas y los créditos disponibles. El límite de velocidad mostrado cubre solo pruebas gratuitas; los usuarios autenticados con créditos pueden continuar por encima de ese límite gastando un crédito por prueba adicional.

Obtén ayuda o reporta un problema

• Para preguntas de uso y errores reproducibles, abre un issue en GitHub.
• Para informes sensibles a la seguridad, usa el formulario privado Reportar una vulnerabilidad de GitHub. No incluyas credenciales ni datos sensibles en un issue público.
• La Política de Privacidad y los Términos de Uso de Globalping se aplican a este servicio.

---

Desarrollo

src/
├── index.ts        # Main entry point & MCP agent definition
├── app.ts          # OAuth web routes
├── api/            # Globalping API client
├── auth/           # Authentication helpers
├── config/         # Configuration & constants
├── lib/            # Utilities
├── mcp/            # MCP tool definitions & handlers
├── types/          # TypeScript interfaces
└── ui/             # OAuth HTML templates

Credenciales y Secretos

Almacena las credenciales de OAuth:

npx wrangler secret put GLOBALPING_CLIENT_ID

Para la verificación de dominio del directorio de complementos de OpenAI, almacena el token generado por el portal de envío:

npx wrangler secret put OPENAI_APPS_CHALLENGE

El Worker sirve este valor como texto plano desde /.well-known/openai-apps-challenge. La ruta devuelve 404 hasta que se configure el secreto.

Configuración de Almacenamiento KV

Para la gestión de estado de OAuth en Cloudflare Workers:

1. Crea un espacio de nombres KV: npx wrangler kv:namespace create OAUTH_KV
2. Configura OAUTH_KV dentro de wrangler.jsonc.