Globalping MCP Server

oficial

Acesso à rede com capacidade de executar comandos como ping, traceroute, mtr, http, dns resolve.

GitHub
59

Documentação

Servidor MCP Globalping

Globalping Logo

Permita que modelos de IA interajam com uma plataforma global de medição de rede através de linguagem natural. Dê acesso à rede para qualquer LLM.

MCP Compatible

O que é Globalping?

Globalping é uma API pública e gratuita que fornece acesso a uma rede globalmente distribuída de sondas para monitoramento, depuração e avaliação de infraestrutura de internet. Com o Globalping, você pode executar testes de rede (ping, traceroute, DNS, MTR, HTTP) de milhares de localizações ao redor do mundo.

O que é o Servidor MCP Globalping?

O Servidor MCP Globalping implementa o Model Context Protocol (MCP), permitindo que modelos de IA como GPT da OpenAI e Claude da Anthropic interajam com as capacidades de medição de rede do Globalping através de linguagem natural.

Ele também suporta dois métodos de autenticação: OAuth e autenticação por token de API. Ambos os métodos oferecem uma forma segura de interagir com nossa API e fornecem limites de taxa mais altos associados à sua conta.

Principais Funcionalidades

  • 🌐 Acesso à Rede Global: Execute medições de milhares de sondas em todo o mundo
  • 🤖 Interface Amigável para IA: Qualquer LLM analisará facilmente os dados e executará novas medições conforme necessário
  • 📊 Medições Abrangentes: Suporte para testes de ping, traceroute, DNS, MTR e HTTP
  • 🔍 Tratamento Inteligente de Contexto: Fornece descrições detalhadas de parâmetros para que clientes de IA selecionem tipos de medição e opções de forma inteligente
  • 🔄 Análise Comparativa: Permite comparar o desempenho de rede entre diferentes alvos
  • 🔑 Suporte à Autenticação: Use OAuth ou token de API com sua conta Globalping para limites de taxa mais altos

Instalação

O servidor MCP remoto está disponível nestes endpoints:

  • Transporte HTTP Transmissível: https://mcp.globalping.dev/mcp
  • Transporte SSE: https://mcp.globalping.dev/sse

Você pode integrar nosso servidor MCP Globalping com várias ferramentas de IA que suportam o Model Context Protocol.

Aqui estão as instruções para as 3 ferramentas mais populares:

Gemini CLI

Para adicionar o servidor MCP Globalping ao Gemini CLI:

  1. Certifique-se de ter o Gemini CLI instalado.
  2. Execute o seguinte comando:
gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

Isso configurará automaticamente o servidor com autenticação OAuth habilitada. Você será solicitado a fazer login quando usar a extensão pela primeira vez.

Nota: Se você preferir usar um token de API Globalping (para limites de taxa mais altos ou automação), pode adicionar o servidor manualmente com o cabeçalho Authorization em vez de usar o instalador da extensão:

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

Aplicativo Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop (localizado em %APPDATA%\Claude\config.json no Windows ou ~/Library/Application Support/Claude/config.json no macOS):

[!note] O Claude Desktop suporta nativamente apenas o transporte stdio para servidores MCP locais. Para servidores MCP remotos, use a ponte mcp-remote.

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

API Anthropic Claude (via Console)

Ao criar um Assistente Claude no Console Anthropic:

  1. Acesse console.anthropic.com
  2. Navegue até a seção Assistants
  3. Crie um novo Assistente ou edite um existente
  4. Na seção Tools, selecione "Add custom tool"
  5. Insira os seguintes detalhes:
    • Nome da Ferramenta: Globalping
    • Descrição: Run network tests from locations worldwide
    • URL da Ferramenta: https://mcp.globalping.dev/mcp (transporte HTTP Transmissível) ou https://mcp.globalping.dev/sse (transporte SSE)

Cursor

Para adicionar o servidor MCP Globalping ao Cursor:

  1. Abra as configurações do Cursor
  2. Navegue até a aba Tools & MCP
  3. Clique em "+ New MCP server"
  4. Isso abre o arquivo de configuração mcp.json, onde você precisará adicionar:

Transporte HTTP Transmissível:

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

Transporte SSE legado:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}
  1. Salve e reinicie o Cursor

Autenticação

O servidor MCP Globalping suporta dois métodos de autenticação:

  • Autenticação OAuth: Tratada automaticamente pelo servidor para acesso seguro
  • Autenticação por Token de API: Configuração manual do token via cabeçalho Authorization

Ambos os métodos fornecem limites de taxa mais altos e acesso prioritário à rede de sondas.

Usando Token de API Globalping

O servidor detecta automaticamente quando um token de API é fornecido no cabeçalho Authorization e o utiliza para autenticação em vez de OAuth.

Obtendo Seu Token de API

  1. Visite dash.globalping.io
  2. Faça login na sua conta
  3. Navegue até Tokens para gerar um novo token de API

Configuração com Autenticação

Transporte HTTP Transmissível:

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

Transporte SSE legado:

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

Conectando Assistentes de IA

Você pode usar nosso servidor MCP com qualquer assistente de IA compatível com MCP, incluindo:

  • Claude Desktop
  • Anthropic Assistants
  • Cursor
  • Windsurf
  • Qualquer implementação personalizada do protocolo MCP

Consulte a documentação MCP da sua ferramenta para obter detalhes sobre como conectar clientes a este servidor.

Ferramentas Disponíveis

  • ping - Realiza um teste de ping para um alvo
  • traceroute - Realiza um teste de traceroute para um alvo
  • dns - Realiza uma consulta DNS para um domínio
  • mtr - Realiza um teste MTR (My Traceroute) para um alvo
  • http - Realiza uma requisição HTTP para uma URL
  • locations - Lista todas as localizações de sondas Globalping disponíveis
  • limits - Mostra seus limites de taxa atuais para a API Globalping
  • getMeasurement - Recupera uma medição executada anteriormente pelo ID
  • compareLocations - Guia sobre como executar medições de comparação
  • help - Mostra uma mensagem de ajuda com documentação sobre as ferramentas disponíveis

Exemplos de Uso

Uma vez conectado a um modelo de IA através de um cliente MCP compatível, você pode interagir com o Globalping usando linguagem 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?

Especificação de Localização

As localizações podem ser especificadas usando o campo "magic", que suporta vários formatos:

  • Códigos de continente: "EU", "NA", "AS", etc.
  • Códigos de país: "US", "DE", "JP", etc.
  • Nomes de cidades: "London", "Tokyo", "New York", etc.
  • Nomes de redes: "Cloudflare", "Google", etc.
  • Números ASN: "AS13335", "AS15169", etc.
  • Regiões de provedores de nuvem: "aws-us-east-1", "gcp-us-central1", etc.

Você também pode combiná-los com um sinal de mais para um direcionamento mais específico: "London+UK", "Cloudflare+US", etc.

Desenvolvimento

A base de código está organizada em módulos:

  • src/index.ts - Ponto de entrada principal e definição do agente MCP
  • src/app.ts - Rotas web OAuth
  • src/api - Cliente da API Globalping
  • src/auth - Utilitários de autenticação
  • src/config - Configuração e constantes
  • src/lib - Funções utilitárias
  • src/mcp - Manipuladores de ferramentas MCP
  • src/types - Definições de tipo TypeScript
  • src/ui - Modelos HTML

Adicionar credenciais Globalping

Adicione credenciais OAuth Globalping:

  • npx wrangler secret put GLOBALPING_CLIENT_ID

Armazenamento KV

Usado para OAuthProvider docs https://github.com/cloudflare/workers-oauth-provider

  • crie um namespace KV e copie o ID
  • a vinculação para ele deve ser OAUTH_KV
  • configure kv_namespaces no arquivo wrangler.jsonc