Globalping

Globalping MCP Server

Ermöglichen Sie KI-Modellen die Interaktion mit einer globalen Netzwerkmessplattform durch natürliche Sprache. Geben Sie jedem LLM Netzwerkzugriff.

Was ist Globalping?

Globalping ist eine kostenlose, öffentliche API, die Zugriff auf ein global verteiltes Netzwerk von Probes zur Überwachung, Fehlerbehebung und Leistungsbewertung der Internetinfrastruktur bietet. Mit Globalping können Sie Netzwerktests (Ping, Traceroute, DNS, MTR, HTTP) von tausenden Standorten weltweit durchführen.

Was ist der Globalping MCP Server?

Der Globalping MCP Server implementiert das Model Context Protocol (MCP) und ermöglicht es KI-Modellen wie OpenAIs GPT und Anthropics Claude, über natürliche Sprache mit den Netzwerkmessfunktionen von Globalping zu interagieren.

Er unterstützt außerdem zwei Authentifizierungsmethoden: OAuth und API-Token-Authentifizierung. Beide Methoden bieten einen sicheren Weg zur Interaktion mit unserer API und gewähren höhere Ratenlimits, die mit Ihrem Konto verknüpft sind.

Hauptfunktionen

• 🌐 Globaler Netzwerkzugriff: Führen Sie Messungen von tausenden Probes weltweit durch
• 🤖 KI-freundliche Schnittstelle: Jedes LLM kann die Daten einfach parsen und bei Bedarf neue Messungen durchführen
• 📊 Umfassende Messungen: Unterstützung für Ping-, Traceroute-, DNS-, MTR- und HTTP-Tests
• 🔍 Intelligente Kontextbehandlung: Bietet detaillierte Parameterbeschreibungen, damit KI-Clients Messungstypen und -optionen intelligent auswählen können
• 🔄 Vergleichende Analyse: Ermöglicht den Vergleich der Netzwerkleistung zwischen verschiedenen Zielen
• 🔑 Authentifizierungsunterstützung: Verwenden Sie OAuth oder API-Token mit Ihrem Globalping-Konto für höhere Ratenlimits

Installation

Der Remote-MCP-Server ist unter diesen Endpunkten verfügbar:

• Streamable HTTP-Transport: https://mcp.globalping.dev/mcp
• SSE-Transport: https://mcp.globalping.dev/sse

Sie können unseren Globalping MCP Server in verschiedene KI-Tools integrieren, die das Model Context Protocol unterstützen.

Hier sind Anleitungen für die 3 beliebtesten Tools:

Gemini CLI

So fügen Sie den Globalping MCP Server zur Gemini CLI hinzu:

1. Stellen Sie sicher, dass die Gemini CLI installiert ist.
2. Führen Sie den folgenden Befehl aus:

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

Dadurch wird der Server automatisch mit aktivierter OAuth-Authentifizierung konfiguriert. Sie werden bei der ersten Verwendung der Erweiterung zur Anmeldung aufgefordert.

Hinweis: Wenn Sie lieber einen Globalping-API-Token verwenden möchten (für höhere Ratenlimits oder Automatisierung), können Sie den Server manuell mit dem Authorization-Header hinzufügen, anstatt den Erweiterungsinstaller zu verwenden:

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

Claude Desktop App

Fügen Sie zu Ihrer Claude Desktop-Konfigurationsdatei hinzu (befindet sich unter %APPDATA%\Claude\config.json unter Windows oder ~/Library/Application Support/Claude/config.json unter macOS):

[!note] Claude Desktop unterstützt nativ nur den stdio-Transport für lokale MCP-Server. Für Remote-MCP-Server verwenden Sie die mcp-remote-Brücke.

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

Anthropic Claude API (über Console)

Beim Erstellen eines Claude-Assistenten in der Anthropic Console:

1. Gehen Sie zu console.anthropic.com
2. Navigieren Sie zum Bereich Assistenten
3. Erstellen Sie einen neuen Assistenten oder bearbeiten Sie einen bestehenden
4. Wählen Sie im Bereich Tools "Benutzerdefiniertes Tool hinzufügen"
5. Geben Sie die folgenden Details ein:
   • Tool-Name: Globalping
   • Beschreibung: Run network tests from locations worldwide
   • Tool-URL: https://mcp.globalping.dev/mcp (Streamable HTTP-Transport) oder https://mcp.globalping.dev/sse (SSE-Transport)

Cursor

So fügen Sie den Globalping MCP Server zu Cursor hinzu:

1. Öffnen Sie die Cursor-Einstellungen
2. Navigieren Sie zum Tab Tools & MCP
3. Klicken Sie auf "+ Neuer MCP-Server"
4. Dies öffnet die mcp.json-Konfigurationsdatei, in der Sie Folgendes hinzufügen müssen:

Streamable HTTP-Transport:

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

Veralteter SSE-Transport:

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

5. Speichern und starten Sie Cursor neu

Authentifizierung

Der Globalping MCP Server unterstützt zwei Authentifizierungsmethoden:

• OAuth-Authentifizierung: Wird automatisch vom Server für sicheren Zugriff abgewickelt
• API-Token-Authentifizierung: Manuelle Token-Konfiguration über den Authorization-Header

Beide Methoden bieten höhere Ratenlimits und priorisierten Zugriff auf das Probe-Netzwerk.

Globalping API-Token verwenden

Der Server erkennt automatisch, wenn ein API-Token im Authorization-Header bereitgestellt wird, und verwendet ihn anstelle von OAuth zur Authentifizierung.

So erhalten Sie Ihren API-Token

1. Besuchen Sie dash.globalping.io
2. Melden Sie sich bei Ihrem Konto an
3. Navigieren Sie zu Tokens, um einen neuen API-Token zu generieren

Konfiguration mit Authentifizierung

Streamable HTTP-Transport:

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

Veralteter SSE-Transport:

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

KI-Assistenten verbinden

Sie können unseren MCP-Server mit jedem MCP-kompatiblen KI-Assistenten verwenden, einschließlich:

• Claude Desktop
• Anthropic Assistenten
• Cursor
• Windsurf
• Jede benutzerdefinierte Implementierung des MCP-Protokolls

Lesen Sie die MCP-Dokumentation Ihres Tools für Details zum Verbinden von Clients mit diesem Server.

Verfügbare Tools

• ping - Führt einen Ping-Test zu einem Ziel durch
• traceroute - Führt einen Traceroute-Test zu einem Ziel durch
• dns - Führt eine DNS-Abfrage für eine Domain durch
• mtr - Führt einen MTR-Test (My Traceroute) zu einem Ziel durch
• http - Führt eine HTTP-Anfrage an eine URL durch
• locations - Listet alle verfügbaren Globalping-Probe-Standorte auf
• limits - Zeigt Ihre aktuellen Ratenlimits für die Globalping-API an
• getMeasurement - Ruft eine zuvor durchgeführte Messung anhand der ID ab
• compareLocations - Anleitung zur Durchführung von Vergleichsmessungen
• help - Zeigt eine Hilfemeldung mit Dokumentation zu den verfügbaren Tools an

Anwendungsbeispiele

Sobald Sie über einen kompatiblen MCP-Client mit einem KI-Modell verbunden sind, können Sie mit Globalping in natürlicher Sprache interagieren:

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?

Standortangabe

Standorte können über das "magic"-Feld angegeben werden, das verschiedene Formate unterstützt:

• Kontinentcodes: "EU", "NA", "AS" usw.
• Ländercodes: "US", "DE", "JP" usw.
• Städtenamen: "London", "Tokyo", "New York" usw.
• Netzwerknamen: "Cloudflare", "Google" usw.
• ASN-Nummern: "AS13335", "AS15169" usw.
• Cloud-Provider-Regionen: "aws-us-east-1", "gcp-us-central1" usw.

Sie können diese auch mit einem Pluszeichen kombinieren, um eine spezifischere Auswahl zu treffen: "London+UK", "Cloudflare+US" usw.

Entwicklung

Die Codebasis ist in Module gegliedert:

• src/index.ts - Haupteinstiegspunkt und MCP-Agent-Definition
• src/app.ts - OAuth-Webrouten
• src/api - Globalping-API-Client
• src/auth - Authentifizierungsdienstprogramme
• src/config - Konfiguration und Konstanten
• src/lib - Hilfsfunktionen
• src/mcp - MCP-Tool-Handler
• src/types - TypeScript-Typdefinitionen
• src/ui - HTML-Vorlagen

Globalping-Anmeldeinformationen hinzufügen

Fügen Sie Globalping OAuth-Anmeldeinformationen hinzu:

• npx wrangler secret put GLOBALPING_CLIENT_ID

KV-Speicher

Wird für OAuthProvider-Dokumente verwendet https://github.com/cloudflare/workers-oauth-provider

• Erstellen Sie einen KV-Namespace und kopieren Sie die ID
• Die Bindung dafür muss OAUTH_KV sein
• Konfigurieren Sie kv_namespaces in der wrangler.jsonc-Datei