observability-mcp — MCP-сервер для Claude Code: установка
Шлюз наблюдаемости для AI-агентов, объединяющий метрики и логи разных систем через единый интерфейс. Помогает разбирать инциденты в инфраструктуре.
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env PROMETHEUS_URL=<PROMETHEUS_URL> --env LOKI_URL=<LOKI_URL> --transport stdio observability-mcp -- npx -y @thotischner/observability-mcpЧто делает observability-mcp
Сервер работает как промежуточный слой между ИИ-агентом и бэкендами мониторинга вроде Prometheus и Loki. Данные агрегируются на сервере. Вместо сырых массивов агент получает нормализованную выжимку через единую точку входа.
Для анализа топологии и зависимостей предусмотрены вызовы get_topology и get_blast_radius. Они определяют связи между подами и узлами кластера. Инструменты работают только на чтение.
При первом запуске шлюз поднимается без подключённых источников. Настроить коннекторы можно в интерфейсе на порту 3000 или через переменные PROMETHEUS_URL и LOKI_URL. Без указания адресов бэкендов агент не получит метрики.
Какие задачи решает
- найти соседние поды на узле при падении сервиса
- собрать агрегированные метрики из Prometheus без ручных запросов
- оценить радиус поражения инфраструктурной аварии через топологию
- объединить запросы к логам и метрикам в едином интерфейсе
Примеры запросов агенту
- Вызови
get_blast_radiusдляpayment-serviceи покажи поды на том же узле. - Используй
get_topology, чтобы найти связанные сервисы перед перезапуском.
Как установить observability-mcp
Командой платформы
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env PROMETHEUS_URL=<PROMETHEUS_URL> --env LOKI_URL=<LOKI_URL> --transport stdio observability-mcp -- npx -y @thotischner/observability-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add observability-mcp --env MCP_TRANSPORT=<MCP_TRANSPORT> --env PROMETHEUS_URL=<PROMETHEUS_URL> --env LOKI_URL=<LOKI_URL> -- npx -y @thotischner/observability-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"observability-mcp": {
"command": "npx",
"args": [
"-y",
"@thotischner/observability-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"PROMETHEUS_URL": "<PROMETHEUS_URL>",
"LOKI_URL": "<LOKI_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"observability-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@thotischner/observability-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"PROMETHEUS_URL": "<PROMETHEUS_URL>",
"LOKI_URL": "<LOKI_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> -e PROMETHEUS_URL=<PROMETHEUS_URL> -e LOKI_URL=<LOKI_URL> observability-mcp npx -y @thotischner/observability-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о observability-mcp
Как установить observability-mcp в Claude Code?
Выполните команду claude mcp add observability-mcp -- npx -y @thotischner/observability-mcp в терминале.
Что делает observability-mcp?
Сервер нормализует данные из систем мониторинга вроде Prometheus и Loki, предоставляя агенту единый интерфейс с инструментами топологии.
Нужно ли настраивать источники данных перед запуском?
Сервер стартует без готовых подключений. Задать адреса Prometheus и Loki можно через переменные окружения PROMETHEUS_URL и LOKI_URL или в интерфейсе на порту 3000.
