Globalping

Globalping MCP Server

Ermöglicht KI-Modellen die Interaktion mit einer globalen Netzwerk-Messplattform über natürliche Sprache. Gib jedem LLM Netzwerkzugriff.

Was ist Globalping?

Globalping ist eine kostenlose, öffentliche API, die Zugriff auf ein weltweit verteiltes Netzwerk von Probes für Monitoring, Debugging und Benchmarking der Internet-Infrastruktur bietet. Mit Globalping kannst du Netzwerktests (Ping, Traceroute, DNS, MTR, HTTP) von tausenden Standorten weltweit ausführen.

Was ist der Globalping MCP Server?

Der Globalping MCP Server implementiert das Model Context Protocol (MCP) und ermöglicht es KI-Modellen und IDE-Assistenten, über natürliche Sprache mit den Netzwerk-Messfunktionen von Globalping zu interagieren.

Der Server unterstützt sowohl die standardmäßige OAuth-2.0-Authentifizierung als auch die API-Token-Authentifizierung für automatisierte Workflows.

Hauptfunktionen

• 🌐 Globaler Netzwerkzugriff: Führe Messungen von tausenden Probes weltweit durch
• 🤖 KI-freundliche Oberfläche: Jedes LLM kann die Daten problemlos parsen und bei Bedarf neue Messungen ausführen
• 📊 Umfassende Messungen: Unterstützung für Ping-, Traceroute-, DNS-, MTR- und HTTP-Tests
• 🔍 Intelligente Kontextverarbeitung: Detaillierte Parameterbeschreibungen und semantische Tool-Annotationen für intelligentes Agenten-Routing
• 🔄 Vergleichende Analyse: Vergleiche Netzwerklatenz und Routing zwischen verschiedenen Zielen und geografischen Standorten
• 🔑 Authentifizierungsunterstützung: Nutze OAuth oder ein API-Token mit deinem Globalping-Konto für höhere Ratenlimits

---

Installation

Der primäre Endpunkt für alle modernen MCP-Integrationen ist:

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

ChatGPT & Codex

Verbinde Globalping als Remote-MCP-Server in ChatGPT und Codex:

ChatGPT (Web & Desktop)

1. Gehe in ChatGPT zu Einstellungen → Sicherheit und Anmeldung und aktiviere den Entwicklermodus (oder Einstellungen → Funktionen → MCP-Server in ChatGPT Desktop).
2. Füge einen neuen benutzerdefinierten Connector / MCP-Server mit dem Endpunkt hinzu:

https://mcp.globalping.dev/mcp

3. Authentifiziere dich bei Aufforderung über OAuth.

OpenAI Codex

Füge den Remote-Server mit der Codex-CLI hinzu:

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

Oder füge ihn direkt zu ~/.codex/config.toml hinzu:

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

Claude (Web, Desktop)

Claude unterstützt Remote-Streamable-HTTP-MCP-Connectors nativ, ohne dass lokale mcp-remote-Brücken erforderlich sind:

1. Navigiere in Claude zu Einstellungen → Connectors (oder Organisationseinstellungen → Connectors für Team-/Enterprise-Konten).
2. Klicke auf + Benutzerdefinierten Connector hinzufügen.
3. Fülle die Connector-Details aus:

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

Claude Code

Führe den folgenden Befehl in deinem Terminal aus:

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

Um Globalping projektübergreifend auf deinem Rechner verfügbar zu machen (globaler Benutzerbereich) statt nur im aktuellen Projektverzeichnis:

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

Führe claude mcp login globalping --no-browser aus, wenn du über SSH oder in einem Headless-Terminal arbeitest, um den Autorisierungs-URL-Austausch manuell abzuschließen.

Cursor

Füge Globalping mit einem Klick zu Cursor hinzu:

Oder konfiguriere manuell unter Einstellungen → Funktionen → MCP-Server → Neuen MCP-Server hinzufügen:

• Typ: SSE / HTTP
• Name: globalping
• URL: https://mcp.globalping.dev/mcp

Gemini CLI

Globalping ist im offiziellen Gemini CLI Extensions Gallery indexiert.

Installiere über den Gemini-Erweiterungsmanager:

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

(Füge --auto-update hinzu, um die Erweiterung automatisch aktuell zu halten).

VS Code & GitHub Copilot

• Befehlspalette: Führe MCP: Add Server aus und gib https://mcp.globalping.dev/mcp ein.

Generische MCP-Clients

Für jeden Client, der den standardmäßigen Streamable-HTTP-MCP-Transport unterstützt, füge hinzu:

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

Legacy-Clients (SSE / stdio-Fallback): Wenn dein Client strikt SSE über eine lokale Prozessbrücke erfordert, konfiguriere npx mcp-remote https://mcp.globalping.dev/sse.

---

Authentifizierung

Globalping MCP unterstützt zwei Authentifizierungsmodi:

• OAuth 2.0: Wird automatisch in interaktiven Clients während der Verbindung gehandhabt.
• API-Token: Nützlich für Headless-Skripte, CI/CD-Pipelines oder programmatische API-Clients.

Verwenden eines Globalping-API-Tokens

1. Gehe zu dash.globalping.io und generiere ein API-Token unter Tokens.
2. Übergib das Token über standardmäßige HTTP-Header:

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

---

Programmatische Integration (Anthropic Messages API)

Um Globalping direkt mit der Anthropic Messages API (MCP-Connector) zu verwenden, übergib die Remote-Server-Definition in deiner Request-Payload:

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

---

Verfügbare Tools

Tool	Beschreibung
ping	Führe ICMP/Paket-Ping-Tests zu einem Ziel durch
traceroute	Verfolge Netzwerk-Routing-Hops zu einem Ziel
dns	Löse DNS-Abfragen mit bestimmten Resolvern und Record-Typen auf
mtr	Führe kombinierte Ping- und Traceroute-Tests durch (My Traceroute)
http	Führe HTTP/HTTPS-Anfragen von Probes weltweit aus
locations	Liste verfügbare Globalping-Probe-Regionen und Filter auf
limits	Zeige das aktuelle kostenlose Stundenkontingent für Tests und zusätzliche Credits an
getMeasurement	Rufe Ergebnisse einer historischen Messung per ID ab
compareLocations	Hilfreicher Leitfaden zum Vergleich von Multi-Region-Leistungsmetriken
help	Tool-Referenz und Syntaxdokumentation
authStatus	Prüfe den aktuellen MCP-Authentifizierungsstatus

---

Verwendungsbeispiele

Nach der Verbindung kannst du Netzwerkdiagnosen in natürlicher Sprache ausführen:

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 den magic-Parameter angegeben werden:

• Kontinente: EU, NA, AS, AF, OC, SA
• Ländercodes: US, DE, JP, PL, BR
• Städte: London, Tokyo, New York, Warsaw
• Netzwerke & ASNs: Cloudflare, Google, AS13335, AS15169
• Cloud-Regionen: aws-us-east-1, gcp-us-central1
• Kombinationen: London+UK, Cloudflare+US, AWS+Frankfurt

---

Fehlerbehebung und Support

Der Connector kann den Server nicht erreichen

• Verwende den Streamable-HTTP-Endpunkt genau wie angegeben: https://mcp.globalping.dev/mcp.
• Eine 401 Unauthorized-Antwort vor Abschluss von OAuth ist zu erwarten. Verbinde die Integration erneut und schließe den Browser-Autorisierungsablauf ab.
• Verwende den Legacy-/sse-Endpunkt nur für Clients, die Streamable HTTP nicht unterstützen.

Authentifizierung schlägt fehl oder läuft ab

• Entferne und verbinde die Integration erneut, um einen neuen OAuth-Ablauf zu starten.
• Für die API-Token-Authentifizierung generiere ein aktuelles Token im Globalping-Dashboard und sende es als Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
• Nach der Verbindung verwende das authStatus-Tool, um zu überprüfen, ob die Authentifizierung aktiv ist, und das limits-Tool, um das kostenlose Stundenkontingent für Tests und verfügbare Credits zu prüfen. Das angezeigte Ratenlimit gilt nur für kostenlose Tests; authentifizierte Benutzer mit Credits können darüber hinaus fortfahren, indem sie einen Credit pro zusätzlichem Test ausgeben.

Hilfe erhalten oder ein Problem melden

• Für Nutzungsfragen und reproduzierbare Fehler öffne ein GitHub-Issue.
• Für sicherheitsrelevante Meldungen verwende das private Report a vulnerability-Formular von GitHub. Gib keine Zugangsdaten oder sensiblen Daten in einem öffentlichen Issue an.
• Die Datenschutzrichtlinie und die Nutzungsbedingungen von Globalping gelten für diesen Dienst.

---

Entwicklung

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

Zugangsdaten & Secrets

Speichere OAuth-Zugangsdaten:

npx wrangler secret put GLOBALPING_CLIENT_ID

Für die Domain-Verifizierung des OpenAI-Plugin-Verzeichnisses speichere das vom Einreichungsportal generierte Token:

npx wrangler secret put OPENAI_APPS_CHALLENGE

Der Worker liefert diesen Wert als Klartext von /.well-known/openai-apps-challenge. Die Route gibt 404 zurück, bis das Secret konfiguriert ist.

KV-Speicher-Einrichtung

Für das OAuth-Statusmanagement von Cloudflare Workers:

1. Erstelle einen KV-Namespace: npx wrangler kv:namespace create OAUTH_KV
2. Konfiguriere OAUTH_KV innerhalb von wrangler.jsonc.