mcp-infra-lens

Анализ инцидентов в Linux через SSH с помощью инструментов MCP, учитывающих базовые показатели.

Демонстрация

Пример ответа analyze_server, когда Claude спрашивает: "Что не так с prod-01?":

{
  "host": "prod-01.internal",
  "health_score": 42,
  "summary": "Found 2 anomalies on prod-01.internal. Most urgent signal: CPU is at 91% (3.4σ above baseline 28.2%). Load is 7.2/6.8/5.1. Top CPU consumer: java (87%).",
  "anomalies": [
    {
      "metric": "cpu",
      "severity": "high",
      "value": 91,
      "z_score": 3.4,
      "explanation": "CPU is at 91% (3.4σ above baseline 28.2%). Load is 7.2/6.8/5.1. Top CPU consumer: java (87%).",
      "recommendation": "Investigate java (PID 18432) and review application logs or scale-out options."
    },
    {
      "metric": "disk:/",
      "severity": "high",
      "value": 91,
      "explanation": "Disk / is 91% full (182GB/200GB).",
      "recommendation": "Run du -sh //* | sort -rh | head -20 and clean logs or temporary files."
    }
  ]
}

Что это делает

mcp-infra-lens подключается к хостам Linux по SSH, делает моментальный снимок инфраструктуры в реальном времени, сравнивает его с недавно записанными базовыми показателями и объясняет аномалии простым языком.

• Собирает данные о процессоре, памяти, диске, сети, процессах и ОС, не изменяя целевой хост

• Записывает историю локальных метрик в SQLite для создания базовых показателей, сравнений и поиска трендов

• Использует z-оценку для обнаружения аномалий процессора при наличии достаточного количества базовых выборок

• Объясняет вероятную причину нагрузки, а не просто выводит необработанные значения метрик

• Поддерживает MCP через stdio и Streamable HTTP

Как это работает

flowchart TD
    A["Claude / Cursor / VS Code / Windsurf"] --> B["mcp-infra-lens"]
    B --> C["server-core.ts"]
    C --> D["collector.ts"]
    C --> E["analyzer.ts"]
    C --> F["baseline.ts + db.ts"]
    D --> G["ssh.ts"]
    G --> H["Linux host over SSH"]
    F --> I["SQLite history + baselines"]

analyze_server теперь выполняет сбор данных в течение указанного duration_minutes, усредняет нагрузку на процессор и память за период сбора, сохраняет полученный снимок, а затем запускает обнаружение аномалий относительно выбранного базового показателя.

Инструменты

Быстрый старт

1. Запуск через npx

npx -y mcp-infra-lens

Если вы зафиксировали версию 1.0.1, обновитесь до 1.0.2 или новее, чтобы избежать ошибок при установке нативных модулей в Node 24:

npx -y mcp-infra-lens@latest

2. Claude Desktop

Опубликованный пакет:

{
  "mcpServers": {
    "infra-lens": {
      "command": "npx",
      "args": ["-y", "mcp-infra-lens"],
      "env": {
        "INFRA_LENS_DB": "/Users/you/.mcp-infra-lens/metrics.db"
      }
    }
  }
}

Локальная разработка:

{
  "mcpServers": {
    "infra-lens": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-infra-lens/dist/mcp.js"],
      "env": {
        "INFRA_LENS_DB": "/Users/you/.mcp-infra-lens/metrics.db"
      }
    }
  }
}

3. Docker

docker build -t mcp-infra-lens .
docker run --rm -it \
  -v "$HOME/.mcp-infra-lens:/home/appuser/.mcp-infra-lens" \
  mcp-infra-lens

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

Оценка состояния (Health Score)

• 90-100: здорово, значимых аномалий не обнаружено

• 70-89: умеренная или локальная нагрузка

• 40-69: несколько предупреждений или серьезная проблема в процессе

• 0-39: критическое состояние, требуется срочное вмешательство

Рекомендуемый рабочий процесс

1. Записывайте выборки record_baseline во время нормальной работы системы.

2. Используйте analyze_server во время инцидентов или скачков нагрузки.

3. Используйте compare_to_baseline для более детального сравнения с конкретным базовым состоянием.

4. Используйте get_history для отслеживания трендов и отделения обычных снимков от помеченных базовых сессий.

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

Схема ввода SSH поддерживает:

• Аутентификацию по паролю

• Аутентификацию по закрытому ключу (inline)

• Опциональную поддержку парольной фразы для зашифрованных ключей

Поля с учетными данными удаляются из структурированных логов перед записью в stderr.

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

• Сбор данных по SSH осуществляется только для чтения на целевом хосте

• Учетные данные SSH никогда не сохраняются в SQLite

• Проверка ключа хоста в версии v1 является разрешительной для совместимости; в производственных развертываниях следует ограничить исходящий сетевой доступ и планировать принудительную строгую проверку хоста в будущих релизах

• HTTP-транспорт не имеет встроенной аутентификации; привязывайтесь к loopback и размещайте его за аутентифицированным обратным прокси в любых нелокальных развертываниях

См. SECURITY.md для ознакомления с политикой отчетности и областью хранения данных.

Интеграции

Claude Desktop

{
  "mcpServers": {
    "infra-lens": {
      "command": "npx",
      "args": ["-y", "mcp-infra-lens"],
      "env": {
        "INFRA_LENS_DB": "/Users/you/.mcp-infra-lens/metrics.db"
      }
    }
  }
}

Cursor IDE

{
  "mcpServers": {
    "infra-lens": {
      "command": "npx",
      "args": ["-y", "mcp-infra-lens"]
    }
  }
}

VS Code (MCP extension)

{
  "inputs": [],
  "servers": {
    "infra-lens": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-infra-lens"]
    }
  }
}

Windsurf

{
  "mcpServers": {
    "infra-lens": {
      "command": "npx",
      "args": ["-y", "mcp-infra-lens"]
    }
  }
}

Docker (HTTP transport)

docker run -d \
  -p 3000:3000 \
  -v $HOME/.mcp-infra-lens:/home/appuser/.mcp-infra-lens \
  ghcr.io/oaslananka/mcp-infra-lens:latest

Затем настройте ваш MCP-клиент на использование http://localhost:3000.

Docker

Входящий в комплект образ Docker:

• Собирает проект TypeScript на отдельном этапе

• Пересобирает better-sqlite3 для архитектуры контейнера на обоих этапах

• Запускается от имени пользователя appuser (не root)

• Хранит данные SQLite в /home/appuser/.mcp-infra-lens/metrics.db

Вклад в проект

Вклад приветствуется. Начните с CONTRIBUTING.md, затем используйте:

• docs/usage.md для примеров использования инструментов

• docs/architecture.md для карты компонентов

• docs/testing.md для локальной проверки и проверок перед публикацией

• RELEASE_POLICY.md для правил версионирования npm и MCP Registry

• AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md и .agent/rules/repository.md для специфических рекомендаций по AI-кодингу в репозитории

Заметки по эксплуатации / CI

• azure-pipelines.yml является каноническим CI-конвейером и теперь выполняет этап Quality на Node 20 и Node 22, публикует артефакты JUnit и Cobertura, а также выполняет SSH e2e-тестирование на базе Docker на Node 20

• .azure/pipelines/publish.yml остается ручным конвейером для релиза npm

• .azure/pipelines/mirror.yml остается доступным для рабочих процессов зеркалирования репозитория

• Публикуйте только после того, как локальный чек-лист перед публикацией и CI успешно пройдены на Node 20

• Следуйте RELEASE_POLICY.md при принятии решения о том, требует ли изменение публикации в npm, MCP Registry или только предрелизной публикации в реестре

Лицензия

MIT