MCP-сервер Visual Sentinel

Сервер протокола контекста модели (MCP) для Visual Sentinel, платформы шестиуровневого мониторинга веб-сайтов: аптайм, производительность, SSL, DNS, визуальная регрессия и обнаружение изменений контента.

Подключите Claude Desktop, Claude Code, Cline, Continue или любой другой MCP-совместимый клиент к своей учетной записи Visual Sentinel, чтобы ИИ-ассистент мог перечислять мониторы, создавать их, получать историю инцидентов, запускать бесплатные проверки DNS / SSL / скорости и подтверждать оповещения от вашего имени.

• npm: @visualsentinel/mcp-server

• Спецификация OpenAPI: https://github.com/VisualSentinel/openapi

• Получить API-ключ: https://visualsentinel.com/settings/api-keys

• Справочник по API: https://visualsentinel.com/docs

Что вы получаете

16 инструментов, охватывающих публичный API Visual Sentinel:

Публичные инструменты (API-ключ не требуется)

Авторизованные инструменты (требуется VS_API_KEY)

Установка

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "visualsentinel": {
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": {
        "VS_API_KEY": "vs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Перезапустите Claude Desktop. 16 инструментов появятся в меню инструментов.

Claude Code (CLI)

claude mcp add visualsentinel \
  -- npx -y @visualsentinel/mcp-server

Затем экспортируйте VS_API_KEY в оболочке, где запускается Claude Code.

Cline (расширение VS Code)

В настройках MCP для Cline добавьте:

{
  "visualsentinel": {
    "command": "npx",
    "args": ["-y", "@visualsentinel/mcp-server"],
    "env": { "VS_API_KEY": "vs_live_..." }
  }
}

Continue

В ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "visualsentinel",
      "command": "npx",
      "args": ["-y", "@visualsentinel/mcp-server"],
      "env": { "VS_API_KEY": "vs_live_..." }
    }
  ]
}

Универсальный MCP-клиент (stdio)

VS_API_KEY=vs_live_xxx npx -y @visualsentinel/mcp-server

Сервер использует JSON-RPC через stdio согласно спецификации MCP (2025-06-18).

Конфигурация

Две переменные окружения, обе опциональны, за исключением указанных случаев:

Если инструмент, требующий авторизации, вызывается без VS_API_KEY, сервер возвращает понятную ошибку, а не просто завершается с ошибкой.

VISUALSENTINEL_API_KEY принимается как псевдоним для VS_API_KEY для клиентов, предпочитающих более длинное имя.

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

После установки спрашивайте ИИ-ассистента о следующем:

• "Какова ситуация с SSL-сертификатом на visualsentinel.com? Когда он истекает?"

• "Перечисли мои мониторы Visual Sentinel, которые сейчас не работают."

• "Добавь новый HTTPS-монитор для https://shop.example.com с проверкой каждую минуту."

• "Покажи мне инциденты за последние 24 часа и подтверди те, что относятся к монитору с ID clm123."

• "Каков процент аптайма для моей целевой страницы за последние 30 дней?"

• "Запусти тест скорости для https://example.com/checkout."

Ассистент выбирает подходящий инструмент, заполняет аргументы из разговора и показывает JSON-ответ.

Заметки по безопасности

• Ваш API-ключ никогда не покидает машину, на которой запущен этот MCP-сервер. Запросы отправляются напрямую на https://visualsentinel.com через HTTPS.

• Публичные инструменты (vs_health, vs_dns_check, vs_ssl_check, vs_speed_test, vs_website_check) работают без API-ключа, но их результаты видны любому, кто может прочитать логи вашего разговора. Относитесь к ним как к любой другой команде оболочки.

• Немедленно отзовите скомпрометированный API-ключ на https://visualsentinel.com/settings/api-keys. Отзыв вступает в силу в течение нескольких секунд.

• Инструменты, изменяющие состояние (vs_monitors_create, vs_monitors_check_now, vs_alerts_acknowledge), наследуют ролевые разрешения вашего API-ключа. Ключ только для чтения не может создавать мониторы.

Разработка

git clone https://github.com/VisualSentinel/mcp-server.git
cd mcp-server
npm install
npm run build      # tsup, output to dist/
npm run lint       # tsc --noEmit
npm run dev        # tsup --watch

Для локального дымового тестирования против API в продакшене:

VS_API_KEY=vs_live_... node dist/index.js

Сервер использует JSON-RPC через stdin / stdout. Передайте запрос tools/list через конвейер, чтобы увидеть зарегистрированные инструменты.

Версионирование

Семантическое версионирование. Критические изменения имен инструментов или обязательных аргументов приводят к увеличению мажорной версии. Добавление новых инструментов или новых опциональных аргументов — это минорное обновление или патч.

Инструментарий сервера отслеживает спецификацию публичного API Visual Sentinel на https://github.com/VisualSentinel/openapi. Когда в вышестоящем API появляется полезный эндпоинт, этот репозиторий обычно обновляется в течение одного релиза.

Лицензия

MIT. См. LICENSE.

Сам сервис API Visual Sentinel регулируется условиями https://visualsentinel.com/terms.