Globalping

Глобализация MCP-сервера

Что такое глобализация?

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

Что такое сервер Globalping MCP?

Сервер Globalping MCP реализует протокол контекста модели (MCP) , позволяющий моделям ИИ, таким как GPT от OpenAI и Claude от Anthropic, взаимодействовать с возможностями сетевых измерений Globalping посредством естественного языка.

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

Основные характеристики

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

Установка

Удаленный сервер MCP доступен по этой конечной точке https://mcp.globalping.dev/sse

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

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

Приложение Клод для ПК

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

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

При создании помощника Клода в Anthropic Console:

1. Перейти на console.anthropic.com
2. Перейдите в раздел «Помощники».
3. Создайте нового помощника или отредактируйте существующего
4. В разделе «Инструменты» выберите «Добавить пользовательский инструмент».
5. Введите следующие данные:
   • Название инструмента: Globalping
   • Описание: Run network tests from locations worldwide
   • URL-адрес инструмента: https://mcp.globalping.dev/sse

Курсор

Чтобы добавить сервер Globalping MCP в Cursor:

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

5. Нажмите «Сохранить» и перезапустите курсор.

Подключение помощников на основе искусственного интеллекта

Этот сервер MCP можно использовать с любым совместимым с MCP помощником на базе искусственного интеллекта, включая:

• Клод Десктоп
• Антропные помощники
• Курсор
• Виндсерфинг
• Любая индивидуальная реализация протокола MCP

Подробную информацию о подключении клиентов к этому серверу см. в документации MCP.

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

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

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

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

Спецификация местоположения

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

• Коды континентов: «EU», «NA», «AS» и т. д.
• Коды стран: «US», «DE», «JP» и т. д.
• Названия городов: «Лондон», «Токио», «Нью-Йорк» и т. д.
• Названия сетей: «Cloudflare», «Google» и т. д.
• Номера ASN: «AS13335», «AS15169» и т. д.
• Регионы облачных провайдеров: «aws-us-east-1», «gcp-us-central1» и т. д.

Вы также можете объединить их со знаком плюс для более точного таргетинга: «Лондон+Великобритания», «Cloudflare+США» и т. д.

Разработка

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

• src/index.ts — Основная точка входа и определение агента MCP
• src/globalping/types.ts — интерфейсы TypeScript для API Globalping
• src/globalping/api.ts — API-функции-оболочки для Globalping
• src/globalping/tools.ts — Реализации инструментов MCP
• src/utils.ts — Вспомогательные утилиты для рендеринга веб-интерфейса

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

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

• npx wrangler secret put GLOBALPING_CLIENT_ID

Хранилище КВ

Используется для документации OAuthProvider https://github.com/cloudflare/workers-oauth-provider

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