Globalping

Globalping MCP Server

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

Что такое Globalping?

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

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

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

Сервер поддерживает стандартную аутентификацию OAuth 2.0, а также аутентификацию по API-токену для автоматизированных рабочих процессов.

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

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

---

Установка

Основная конечная точка для всех современных MCP-интеграций:

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

ChatGPT и Codex

Подключите Globalping как удалённый MCP-сервер в ChatGPT и Codex:

ChatGPT (Web и Desktop)

1. В ChatGPT перейдите в Настройки → Безопасность и вход и включите Режим разработчика (или Настройки → Функции → MCP-серверы в ChatGPT Desktop).
2. Добавьте новый пользовательский коннектор / MCP-сервер с конечной точкой:

https://mcp.globalping.dev/mcp

3. Пройдите аутентификацию через OAuth при появлении запроса.

OpenAI Codex

Добавьте удалённый сервер с помощью Codex CLI:

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

Или добавьте напрямую в ~/.codex/config.toml:

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

Claude (Web, Desktop)

Claude нативно поддерживает удалённые Streamable HTTP MCP-коннекторы без необходимости в локальных mcp-remote мостах:

1. В Claude перейдите в Настройки → Коннекторы (или Настройки организации → Коннекторы для аккаунтов Team/Enterprise).
2. Нажмите + Добавить пользовательский коннектор.
3. Заполните данные коннектора:

• Название: Globalping
• URL: https://mcp.globalping.dev/mcp

Claude Code

Выполните следующую команду в терминале:

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

Чтобы сделать Globalping доступным во всех проектах на вашем компьютере (глобальная область пользователя), а не только в текущем каталоге проекта:

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

Запустите claude mcp login globalping --no-browser при работе через SSH или в терминале без графического интерфейса, чтобы вручную завершить обмен URL-адресами авторизации.

Cursor

Добавьте Globalping в Cursor в один клик:

Или настройте вручную в Настройки → Функции → MCP-серверы → Добавить новый MCP-сервер:

• Тип: SSE / HTTP
• Название: globalping
• URL: https://mcp.globalping.dev/mcp

Gemini CLI

Globalping включён в официальную галерею расширений Gemini CLI.

Установите через менеджер расширений Gemini:

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

(Добавьте --auto-update, чтобы расширение обновлялось автоматически).

VS Code и GitHub Copilot

• Палитра команд: Выполните MCP: Add Server и введите https://mcp.globalping.dev/mcp.

Универсальные MCP-клиенты

Для любого клиента, поддерживающего стандартный Streamable HTTP MCP-транспорт, добавьте:

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

Устаревшие клиенты (SSE / stdio fallback): Если ваш клиент строго требует SSE через локальный процесс-мост, настройте npx mcp-remote https://mcp.globalping.dev/sse.

---

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

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

• OAuth 2.0: Обрабатывается автоматически в интерактивных клиентах при подключении.
• API-токен: Полезен для скриптов без графического интерфейса, CI/CD конвейеров или программных API-клиентов.

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

1. Перейдите на dash.globalping.io и создайте API-токен в разделе Токены.
2. Передайте токен через стандартные HTTP-заголовки:

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

---

Программная интеграция (Anthropic Messages API)

Чтобы использовать Globalping напрямую с Anthropic Messages API (MCP Connector), передайте определение удалённого сервера в вашем запросе:

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

---

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

Инструмент	Описание
ping	Выполнение ICMP/пакетных ping-тестов до указанного адресата
traceroute	Трассировка сетевых маршрутов до цели
dns	Разрешение DNS-запросов с использованием конкретных резолверов и типов записей
mtr	Запуск комбинированных тестов ping и traceroute (My Traceroute)
http	Выполнение HTTP/HTTPS-запросов с проб по всему миру
locations	Список доступных регионов проб Globalping и фильтров
limits	Отображение текущего бесплатного почасового лимита тестов и дополнительных кредитов
getMeasurement	Получение результатов исторического измерения по ID
compareLocations	Справочное руководство для сравнения показателей производительности в нескольких регионах
help	Справочная документация по инструментам и синтаксису
authStatus	Проверка текущего статуса аутентификации MCP

---

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

После подключения запускайте сетевую диагностику с помощью естественного языка:

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?

---

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

Местоположения можно указывать с помощью параметра magic:

• Континенты: EU, NA, AS, AF, OC, SA
• Коды стран: US, DE, JP, PL, BR
• Города: London, Tokyo, New York, Warsaw
• Сети и ASN: Cloudflare, Google, AS13335, AS15169
• Облачные регионы: aws-us-east-1, gcp-us-central1
• Комбинации: London+UK, Cloudflare+US, AWS+Frankfurt

---

Устранение неполадок и поддержка

Коннектор не может подключиться к серверу

• Используйте конечную точку Streamable HTTP точно так, как показано: https://mcp.globalping.dev/mcp.
• Ответ 401 Unauthorized до завершения OAuth является ожидаемым. Переподключите интеграцию и завершите процесс авторизации в браузере.
• Используйте устаревшую конечную точку /sse только для клиентов, которые не поддерживают Streamable HTTP.

Сбой или истечение срока аутентификации

• Удалите и переподключите интеграцию, чтобы начать новый OAuth-процесс.
• Для аутентификации по API-токену создайте актуальный токен в панели управления Globalping и отправьте его как Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
• После подключения используйте инструмент authStatus для проверки активности аутентификации и инструмент limits для проверки бесплатного почасового лимита тестов и доступных кредитов. Отображаемый лимит запросов распространяется только на бесплатные тесты; аутентифицированные пользователи с кредитами могут продолжать работу сверх лимита, расходуя один кредит за каждый дополнительный тест.

Получить помощь или сообщить о проблеме

• По вопросам использования и воспроизводимым ошибкам откройте issue на GitHub.
• Для сообщений, связанных с безопасностью, используйте приватную форму GitHub Report a vulnerability. Не включайте учётные данные или конфиденциальные данные в публичные issues.
• На этот сервис распространяются Политика конфиденциальности и Условия использования Globalping.

---

Разработка

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

Учётные данные и секреты

Храните учётные данные OAuth:

npx wrangler secret put GLOBALPING_CLIENT_ID

Для проверки домена в каталоге плагинов OpenAI сохраните токен, сгенерированный порталом подачи заявок:

npx wrangler secret put OPENAI_APPS_CHALLENGE

Worker предоставляет это значение в виде обычного текста из /.well-known/openai-apps-challenge. Маршрут возвращает 404 до тех пор, пока секрет не будет настроен.

Настройка KV-хранилища

Для управления состоянием OAuth в Cloudflare Workers:

1. Создайте пространство имён KV: npx wrangler kv:namespace create OAUTH_KV
2. Настройте OAUTH_KV внутри wrangler.jsonc.