Globalping

официальный

Сетевой доступ с возможностью выполнения команд, таких как ping, traceroute, mtr, http, dns resolve.

GitHub
62

Что можно делать с Globalping MCP?

  • Запуск ping-тестов с глобальных зондов — Попросите ассистента выполнить ping до цели из определенных регионов, стран или городов с помощью ping.
  • Трассировка сетевых путей с помощью traceroute или MTR — Запросите traceroute или mtr, чтобы визуализировать маршрут пакетов от глобальных точек зондирования.
  • Запрос DNS-записей из любого местоположения — Используйте dns для разрешения домена с пользовательскими резолверами (например, Google DNS) с зондов по всему миру.
  • Проверка доступности HTTP и времени отклика — Запустите http-тест для URL, чтобы измерить коды состояния, время и заголовки из разных регионов.
  • Сравнение производительности сети в разных местах — Используйте инструкцию compareLocations для параллельных измерений и сравнения задержки или маршрутизации между целями.
  • Получение предыдущих измерений и проверка лимитов запросов — Получите предыдущий результат по ID с помощью getMeasurement или просмотрите текущие лимиты API через limits.

Документация

Globalping MCP Server

Globalping Logo

Позвольте ИИ-моделям взаимодействовать с глобальной платформой сетевых измерений через естественный язык. Предоставьте сетевой доступ любой LLM.

MCP Compatible

Что такое Globalping?

Globalping — это бесплатный публичный API, предоставляющий доступ к глобально распределенной сети зондов для мониторинга, отладки и тестирования интернет-инфраструктуры. С помощью Globalping вы можете запускать сетевые тесты (ping, traceroute, DNS, MTR, HTTP) из тысяч точек по всему миру.

Что такое Globalping MCP Server?

Globalping MCP Server реализует Model Context Protocol (MCP), позволяя ИИ-моделям, таким как GPT от OpenAI и Claude от Anthropic, взаимодействовать с возможностями сетевых измерений Globalping через естественный язык.

Он также поддерживает два метода аутентификации: OAuth и аутентификацию по API-токену. Оба метода обеспечивают безопасное взаимодействие с нашим API и предоставляют повышенные лимиты запросов, связанные с вашей учетной записью.

Ключевые возможности

  • 🌐 Глобальный доступ к сети: Запуск измерений из тысяч зондов по всему миру
  • 🤖 Удобный для ИИ интерфейс: Любая LLM легко разберет данные и при необходимости запустит новые измерения
  • 📊 Комплексные измерения: Поддержка тестов ping, traceroute, DNS, MTR и HTTP
  • 🔍 Умная обработка контекста: Предоставляет подробные описания параметров, чтобы ИИ-клиенты могли разумно выбирать типы измерений и опции
  • 🔄 Сравнительный анализ: Позволяет сравнивать производительность сети между разными целями
  • 🔑 Поддержка аутентификации: Используйте OAuth или API-токен с вашей учетной записью Globalping для повышенных лимитов

Установка

Удаленный MCP-сервер доступен по следующим адресам:

  • Streamable HTTP транспорт: https://mcp.globalping.dev/mcp
  • SSE транспорт: https://mcp.globalping.dev/sse

Вы можете интегрировать наш Globalping MCP Server с различными ИИ-инструментами, поддерживающими Model Context Protocol.

Вот инструкции для трех самых популярных инструментов:

Gemini CLI

Чтобы добавить Globalping MCP Server в Gemini CLI:

  1. Убедитесь, что у вас установлен Gemini CLI.
  2. Выполните следующую команду:
gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

Это автоматически настроит сервер с включенной OAuth-аутентификацией. При первом использовании расширения вам будет предложено войти в систему.

Примечание: Если вы предпочитаете использовать API-токен Globalping (для повышенных лимитов или автоматизации), вы можете вручную добавить сервер с заголовком Authorization вместо использования установщика расширений:

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

Claude Desktop App

Добавьте в конфигурационный файл Claude Desktop (находится в %APPDATA%\Claude\config.json на Windows или ~/Library/Application Support/Claude/config.json на macOS):

[!note] Claude Desktop изначально поддерживает только транспорт stdio для локальных MCP-серверов. Для удаленных MCP-серверов используйте мост mcp-remote.

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

Anthropic Claude API (через Консоль)

При создании Claude Assistant в Anthropic Console:

  1. Перейдите на console.anthropic.com
  2. Перейдите в раздел Assistants
  3. Создайте нового Assistant или отредактируйте существующего
  4. В разделе Tools выберите "Add custom tool"
  5. Введите следующие данные:
    • Tool Name: Globalping
    • Description: Run network tests from locations worldwide
    • Tool URL: https://mcp.globalping.dev/mcp (Streamable HTTP транспорт) или https://mcp.globalping.dev/sse (SSE транспорт)

Cursor

Чтобы добавить Globalping MCP Server в Cursor:

  1. Откройте настройки Cursor
  2. Перейдите на вкладку Tools & MCP
  3. Нажмите "+ New MCP server"
  4. Откроется конфигурационный файл mcp.json, куда нужно добавить:

Streamable HTTP транспорт:

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

Устаревший SSE транспорт:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}
  1. Сохраните и перезапустите Cursor

Аутентификация

Globalping MCP Server поддерживает два метода аутентификации:

  • OAuth-аутентификация: Автоматически обрабатывается сервером для безопасного доступа
  • Аутентификация по API-токену: Ручная настройка токена через заголовок Authorization

Оба метода обеспечивают повышенные лимиты запросов и приоритетный доступ к сети зондов.

Использование API-токена Globalping

Сервер автоматически определяет, когда в заголовке Authorization предоставлен API-токен, и использует его для аутентификации вместо OAuth.

Получение вашего API-токена

  1. Посетите dash.globalping.io
  2. Войдите в свою учетную запись
  3. Перейдите в раздел Tokens, чтобы сгенерировать новый API-токен

Конфигурация с аутентификацией

Streamable HTTP транспорт:

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

Устаревший SSE транспорт:

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

Подключение ИИ-ассистентов

Вы можете использовать наш MCP-сервер с любым MCP-совместимым ИИ-ассистентом, включая:

  • Claude Desktop
  • Anthropic Assistants
  • Cursor
  • Windsurf
  • Любую пользовательскую реализацию протокола MCP

Смотрите MCP-документацию вашего инструмента для получения подробностей о подключении клиентов к этому серверу.

Доступные инструменты

  • ping - Выполнить ping-тест до цели
  • traceroute - Выполнить traceroute-тест до цели
  • dns - Выполнить DNS-запрос для домена
  • mtr - Выполнить MTR (My Traceroute) тест до цели
  • http - Выполнить HTTP-запрос к URL
  • locations - Показать список всех доступных точек размещения зондов Globalping
  • limits - Показать ваши текущие лимиты запросов для Globalping API
  • getMeasurement - Получить ранее выполненное измерение по ID
  • compareLocations - Руководство по выполнению сравнительных измерений
  • help - Показать справочное сообщение с документацией по доступным инструментам

Примеры использования

После подключения к ИИ-модели через совместимый MCP-клиент вы можете взаимодействовать с Globalping, используя естественный язык:

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?

Указание местоположения

Местоположения можно указывать с помощью "магического" поля, которое поддерживает различные форматы:

  • Коды континентов: "EU", "NA", "AS" и т.д.
  • Коды стран: "US", "DE", "JP" и т.д.
  • Названия городов: "London", "Tokyo", "New York" и т.д.
  • Названия сетей: "Cloudflare", "Google" и т.д.
  • Номера ASN: "AS13335", "AS15169" и т.д.
  • Регионы облачных провайдеров: "aws-us-east-1", "gcp-us-central1" и т.д.

Вы также можете комбинировать их через знак плюс для более точного указания: "London+UK", "Cloudflare+US" и т.д.

Разработка

Кодовая база организована в модули:

  • src/index.ts - Главная точка входа и определение MCP-агента
  • src/app.ts - OAuth веб-маршруты
  • src/api - Клиент Globalping API
  • src/auth - Утилиты аутентификации
  • src/config - Конфигурация и константы
  • src/lib - Вспомогательные функции
  • src/mcp - Обработчики инструментов MCP
  • src/types - Определения типов TypeScript
  • src/ui - HTML-шаблоны

Добавление учетных данных Globalping

Добавьте OAuth-учетные данные Globalping:

  • npx wrangler secret put GLOBALPING_CLIENT_ID

KV-хранилище

Используется для OAuthProvider docs https://github.com/cloudflare/workers-oauth-provider

  • создайте пространство имен KV и скопируйте ID
  • привязка для него должна быть OAUTH_KV
  • настройте kv_namespaces в файле wrangler.jsonc