Globalping

Serveur MCP Globalping

Permettre aux modèles d'IA d'interagir avec une plateforme mondiale de mesure réseau grâce au langage naturel. Donner un accès réseau à n'importe quel LLM.

Qu'est-ce que Globalping ?

Globalping est une API publique gratuite qui donne accès à un réseau mondialement distribué de sondes pour surveiller, déboguer et comparer les performances de l'infrastructure Internet. Avec Globalping, vous pouvez exécuter des tests réseau (ping, traceroute, DNS, MTR, HTTP) depuis des milliers d'emplacements dans le monde.

Qu'est-ce que le serveur MCP Globalping ?

Le serveur MCP Globalping implémente le Model Context Protocol (MCP), permettant aux modèles d'IA et aux assistants IDE d'interagir avec les capacités de mesure réseau de Globalping grâce au langage naturel.

Le serveur prend en charge l'authentification OAuth 2.0 standard ainsi que l'authentification par jeton API pour les flux de travail automatisés.

Fonctionnalités clés

• 🌐 Accès réseau mondial : Exécutez des mesures depuis des milliers de sondes dans le monde entier
• 🤖 Interface adaptée à l'IA : Tout LLM analysera facilement les données et lancera de nouvelles mesures selon les besoins
• 📊 Mesures complètes : Prise en charge des tests ping, traceroute, DNS, MTR et HTTP
• 🔍 Gestion intelligente du contexte : Descriptions détaillées des paramètres et annotations sémantiques des outils pour un routage intelligent des agents
• 🔄 Analyse comparative : Comparez la latence réseau et le routage entre différentes cibles et zones géographiques
• 🔑 Prise en charge de l'authentification : Utilisez OAuth ou un jeton API avec votre compte Globalping pour des limites de débit plus élevées

---

Installation

Le point de terminaison principal pour toutes les intégrations MCP modernes est :

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

ChatGPT et Codex

Connectez Globalping en tant que serveur MCP distant dans ChatGPT et Codex :

ChatGPT (Web et Bureau)

1. Dans ChatGPT, allez dans Paramètres → Sécurité et connexion et activez le mode Développeur (ou Paramètres → Fonctionnalités → Serveurs MCP dans ChatGPT Desktop).
2. Ajoutez un nouveau connecteur personnalisé / serveur MCP avec le point de terminaison :

https://mcp.globalping.dev/mcp

3. Authentifiez-vous via OAuth lorsque vous y êtes invité.

OpenAI Codex

Ajoutez le serveur distant à l'aide du CLI Codex :

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

Ou ajoutez-le à ~/.codex/config.toml directement :

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

Claude (Web, Bureau)

Claude prend en charge nativement les connecteurs MCP HTTP Streamable distants sans nécessiter de ponts mcp-remote locaux :

1. Dans Claude, accédez à Paramètres → Connecteurs (ou Paramètres de l'organisation → Connecteurs pour les comptes Équipe/Entreprise).
2. Cliquez sur + Ajouter un connecteur personnalisé.
3. Renseignez les détails du connecteur :

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

Claude Code

Exécutez la commande suivante dans votre terminal :

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

Pour rendre Globalping disponible dans tous les projets de votre machine (portée utilisateur globale) au lieu du seul répertoire de projet actuel :

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

Exécutez claude mcp login globalping --no-browser si vous travaillez via SSH ou dans un terminal sans interface graphique pour terminer manuellement l'échange d'URL d'autorisation.

Cursor

Ajoutez Globalping à Cursor en un clic :

Ou configurez manuellement dans Paramètres → Fonctionnalités → Serveurs MCP → Ajouter un nouveau serveur MCP :

• Type : SSE / HTTP
• Nom : globalping
• URL : https://mcp.globalping.dev/mcp

CLI Gemini

Globalping est indexé dans la Galerie d'extensions CLI Gemini officielle.

Installez via le gestionnaire d'extensions Gemini :

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

(Ajoutez --auto-update pour que l'extension soit automatiquement mise à jour).

VS Code et GitHub Copilot

• Palette de commandes : Exécutez MCP: Add Server et saisissez https://mcp.globalping.dev/mcp.

Clients MCP génériques

Pour tout client prenant en charge le transport MCP HTTP Streamable standard, ajoutez :

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

Clients hérités (repli SSE / stdio) : Si votre client exige strictement SSE via un pont de processus local, configurez npx mcp-remote https://mcp.globalping.dev/sse.

---

Authentification

Globalping MCP prend en charge deux modes d'authentification :

• OAuth 2.0 : Géré automatiquement dans les clients interactifs lors de la connexion.
• Jeton API : Utile pour les scripts sans interface graphique, les pipelines CI/CD ou les clients API programmatiques.

Utilisation d'un jeton API Globalping

1. Allez sur dash.globalping.io et générez un jeton API sous Jetons.
2. Transmettez le jeton via les en-têtes HTTP standard :

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

---

Intégration programmatique (API Messages Anthropic)

Pour utiliser Globalping directement avec l'API Messages d'Anthropic (connecteur MCP), transmettez la définition du serveur distant dans votre charge utile de requête :

{
  "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."
    }
  ]
}

---

Outils disponibles

Outil	Description
ping	Effectuer des tests ping ICMP/paquets vers une destination
traceroute	Tracer les sauts de routage réseau vers une cible
dns	Résoudre les requêtes DNS à l'aide de résolveurs et de types d'enregistrement spécifiques
mtr	Exécuter des tests combinés ping et traceroute (My Traceroute)
http	Exécuter des requêtes HTTP/HTTPS depuis des sondes dans le monde entier
locations	Lister les régions de sondes Globalping disponibles et les filtres
limits	Afficher l'allocation horaire gratuite actuelle de tests et les crédits supplémentaires
getMeasurement	Récupérer les résultats d'une mesure historique par ID
compareLocations	Guide d'aide pour comparer les métriques de performance multi-régions
help	Référence des outils et documentation de syntaxe
authStatus	Vérifier l'état actuel de l'authentification MCP

---

Exemples d'utilisation

Une fois connecté, exécutez des diagnostics réseau en langage naturel :

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?

---

Spécification des emplacements

Les emplacements peuvent être spécifiés à l'aide du paramètre magic de l'emplacement :

• Continents : EU, NA, AS, AF, OC, SA
• Codes pays : US, DE, JP, PL, BR
• Villes : London, Tokyo, New York, Warsaw
• Réseaux et ASN : Cloudflare, Google, AS13335, AS15169
• Régions cloud : aws-us-east-1, gcp-us-central1
• Combinaisons : London+UK, Cloudflare+US, AWS+Frankfurt

---

Dépannage et support

Le connecteur ne peut pas atteindre le serveur

• Utilisez le point de terminaison HTTP Streamable exactement comme indiqué : https://mcp.globalping.dev/mcp.
• Une réponse 401 Unauthorized avant de terminer OAuth est normale. Reconnectez l'intégration et terminez le flux d'autorisation dans le navigateur.
• Utilisez le point de terminaison /sse hérité uniquement pour les clients qui ne prennent pas en charge HTTP Streamable.

L'authentification échoue ou expire

• Supprimez et reconnectez l'intégration pour démarrer un nouveau flux OAuth.
• Pour l'authentification par jeton API, générez un jeton actuel dans le tableau de bord Globalping et envoyez-le comme Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
• Une fois connecté, utilisez l'outil authStatus pour vérifier que l'authentification est active et l'outil limits pour vérifier l'allocation horaire gratuite de tests et les crédits disponibles. La limite de débit affichée couvre uniquement les tests gratuits ; les utilisateurs authentifiés disposant de crédits peuvent continuer au-delà en dépensant un crédit par test supplémentaire.

Obtenir de l'aide ou signaler un problème

• Pour les questions d'utilisation et les bugs reproductibles, ouvrez un problème GitHub.
• Pour les rapports sensibles à la sécurité, utilisez le formulaire privé Signaler une vulnérabilité de GitHub. N'incluez pas d'identifiants ou de données sensibles dans un problème public.
• La Politique de confidentialité et les Conditions d'utilisation de Globalping s'appliquent à ce service.

---

Développement

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

Identifiants et secrets

Stockez les identifiants OAuth :

npx wrangler secret put GLOBALPING_CLIENT_ID

Pour la vérification du domaine du répertoire de plugins OpenAI, stockez le jeton généré par le portail de soumission :

npx wrangler secret put OPENAI_APPS_CHALLENGE

Le Worker sert cette valeur en texte brut depuis /.well-known/openai-apps-challenge. La route renvoie 404 jusqu'à ce que le secret soit configuré.

Configuration du stockage KV

Pour la gestion d'état OAuth des Cloudflare Workers :

1. Créez un espace de noms KV : npx wrangler kv:namespace create OAUTH_KV
2. Configurez OAUTH_KV dans wrangler.jsonc.