Globalping

officiel

Accès réseau avec la capacité d'exécuter des commandes comme ping, traceroute, mtr, http, dns resolve.

GitHub

Que pouvez-vous faire avec Globalping MCP ?

Exécutez des tests ping depuis des sondes mondiales — Demandez à l'assistant d'effectuer un ping vers une cible depuis des régions, pays ou villes spécifiques en utilisant ping.
Tracez les chemins réseau avec traceroute ou MTR — Demandez un traceroute ou mtr pour visualiser le chemin emprunté par les paquets depuis des emplacements de sondes mondiaux.
Interrogez les enregistrements DNS depuis n'importe quel emplacement — Utilisez dns pour résoudre un domaine avec des résolveurs personnalisés (par exemple, Google DNS) depuis des sondes dans le monde entier.
Vérifiez l'accessibilité HTTP et les temps de réponse — Exécutez un test http sur une URL pour mesurer les codes de statut, les temps et les en-têtes depuis différentes régions.
Comparez les performances réseau entre emplacements — Utilisez les instructions compareLocations pour effectuer des mesures côte à côte et comparer la latence ou le routage entre cibles.
Récupérez les mesures passées et vérifiez les limites de débit — Récupérez un résultat précédent par son ID avec getMeasurement ou consultez les limites actuelles de l'API via limits.

Documentation

Serveur MCP Globalping

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

Qu'est-ce que Globalping ?

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

Qu'est-ce que le serveur MCP Globalping ?

Le serveur MCP Globalping implémente le Model Context Protocol (MCP), permettant à des modèles d'IA comme GPT d'OpenAI et Claude d'Anthropic d'interagir avec les capacités de mesure réseau de Globalping via le langage naturel.

Il prend également en charge deux méthodes d'authentification : OAuth et l'authentification par jeton API. Les deux méthodes offrent un moyen sécurisé d'interagir avec notre API et fournissent des limites de débit plus élevées associées à votre compte.

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 exécutera de nouvelles mesures selon les besoins
📊 Mesures complètes : Prise en charge des tests ping, traceroute, DNS, MTR et HTTP
🔍 Gestion intelligente du contexte : Fournit des descriptions détaillées des paramètres pour que les clients IA puissent sélectionner intelligemment les types de mesures et les options
🔄 Analyse comparative : Permet de comparer les performances réseau entre différentes cibles
🔑 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 serveur MCP distant est disponible via ces points de terminaison :

Transport HTTP streamable : https://mcp.globalping.dev/mcp
Transport SSE : https://mcp.globalping.dev/sse

Vous pouvez intégrer notre serveur MCP Globalping avec divers outils d'IA qui prennent en charge le Model Context Protocol.

Voici les instructions pour les 3 outils les plus populaires :

Gemini CLI

Pour ajouter le serveur MCP Globalping à Gemini CLI :

Assurez-vous d'avoir le Gemini CLI installé.
Exécutez la commande suivante :

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

Cela configurera automatiquement le serveur avec l'authentification OAuth activée. Vous serez invité à vous connecter lors de la première utilisation de l'extension.

Remarque : Si vous préférez utiliser un jeton API Globalping (pour des limites de débit plus élevées ou l'automatisation), vous pouvez ajouter manuellement le serveur avec l'en-tête Authorization au lieu d'utiliser l'installateur d'extension :

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

Application de bureau Claude

Ajoutez à votre fichier de configuration Claude Desktop (situé dans %APPDATA%\Claude\config.json sous Windows ou ~/Library/Application Support/Claude/config.json sous macOS) :

[!note] L'application de bureau Claude ne prend en charge nativement que le transport stdio pour les serveurs MCP locaux. Pour les serveurs MCP distants, utilisez le pont mcp-remote.

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

API Anthropic Claude (via Console)

Lors de la création d'un Assistant Claude dans la Console Anthropic :

Allez sur console.anthropic.com
Naviguez vers la section Assistants
Créez un nouvel Assistant ou modifiez-en un existant
Dans la section Outils, sélectionnez "Ajouter un outil personnalisé"
Entrez les détails suivants :
- Nom de l'outil : Globalping
- Description : Run network tests from locations worldwide
- URL de l'outil : https://mcp.globalping.dev/mcp (transport HTTP streamable) ou https://mcp.globalping.dev/sse (transport SSE)

Cursor

Pour ajouter le serveur MCP Globalping à Cursor :

Ouvrez les paramètres de Cursor
Naviguez vers l'onglet Outils & MCP
Cliquez sur "+ Nouveau serveur MCP"
Cela ouvre le fichier de configuration mcp.json, où vous devrez ajouter :

Transport HTTP streamable :

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

Transport SSE hérité :

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

Sauvegardez et redémarrez Cursor

Authentification

Le serveur MCP Globalping prend en charge deux méthodes d'authentification :

Authentification OAuth : Gérée automatiquement par le serveur pour un accès sécurisé
Authentification par jeton API : Configuration manuelle du jeton via l'en-tête Authorization

Les deux méthodes offrent des limites de débit plus élevées et un accès prioritaire au réseau de sondes.

Utiliser un jeton API Globalping

Le serveur détecte automatiquement lorsqu'un jeton API est fourni dans l'en-tête Authorization et l'utilise pour l'authentification au lieu d'OAuth.

Obtenir votre jeton API

Visitez dash.globalping.io
Connectez-vous à votre compte
Naviguez vers Jetons pour générer un nouveau jeton API

Configuration avec authentification

Transport HTTP streamable :

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

Transport SSE hérité :

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

Connecter des assistants IA

Vous pouvez utiliser notre serveur MCP avec n'importe quel assistant IA compatible MCP, y compris :

Claude Desktop
Assistants Anthropic
Cursor
Windsurf
Toute implémentation personnalisée du protocole MCP

Consultez la documentation MCP de votre outil pour plus de détails sur la connexion des clients à ce serveur.

Outils disponibles

ping - Effectuer un test ping vers une cible
traceroute - Effectuer un test traceroute vers une cible
dns - Effectuer une recherche DNS pour un domaine
mtr - Effectuer un test MTR (My Traceroute) vers une cible
http - Effectuer une requête HTTP vers une URL
locations - Lister tous les emplacements de sondes Globalping disponibles
limits - Afficher vos limites de débit actuelles pour l'API Globalping
getMeasurement - Récupérer une mesure précédemment exécutée par son ID
compareLocations - Guide sur la façon d'exécuter des mesures comparatives
help - Afficher un message d'aide avec la documentation sur les outils disponibles

Exemples d'utilisation

Une fois connecté à un modèle d'IA via un client MCP compatible, vous pouvez interagir avec Globalping en utilisant le 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 de l'emplacement

Les emplacements peuvent être spécifiés en utilisant le champ "magic", qui prend en charge divers formats :

Codes continent : "EU", "NA", "AS", etc.
Codes pays : "US", "DE", "JP", etc.
Noms de ville : "London", "Tokyo", "New York", etc.
Noms de réseau : "Cloudflare", "Google", etc.
Numéros ASN : "AS13335", "AS15169", etc.
Régions de fournisseur cloud : "aws-us-east-1", "gcp-us-central1", etc.

Vous pouvez également les combiner avec un signe plus pour un ciblage plus spécifique : "London+UK", "Cloudflare+US", etc.

Développement

La base de code est organisée en modules :

src/index.ts - Point d'entrée principal et définition de l'agent MCP
src/app.ts - Routes web OAuth
src/api - Client API Globalping
src/auth - Utilitaires d'authentification
src/config - Configuration et constantes
src/lib - Fonctions utilitaires
src/mcp - Gestionnaires d'outils MCP
src/types - Définitions de types TypeScript
src/ui - Modèles HTML

Ajouter des identifiants Globalping

Ajoutez les identifiants OAuth Globalping :

npx wrangler secret put GLOBALPING_CLIENT_ID

Stockage KV

Utilisé pour OAuthProvider docs https://github.com/cloudflare/workers-oauth-provider

créez un espace de noms KV et copiez l'ID
la liaison pour celui-ci doit être OAUTH_KV
configurez kv_namespaces dans le fichier wrangler.jsonc