log-analyzer-mcp

Сервер MCP (Model Context Protocol), предоставляющий инструменты для анализа логов и системных метрик. Подключается к Claude Code через транспорт stdio и предоставляет 5 инструментов для поиска, подсчета и анализа локальных файлов логов.

Возможности

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

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run the server
npm start

Разработка

# Run with hot reload
npm run dev

Интеграция с Claude Code

Добавьте сервер в Claude Code:

# Project-level (only available in this directory)
claude mcp add log-analyzer -- node /path/to/log-analyzer-mcp/dist/index.js

# User-level (available globally)
claude mcp add log-analyzer --scope user -- node /path/to/log-analyzer-mcp/dist/index.js

Проверьте подключение:

claude mcp list

Подробности об инструментах

search_logs

Поиск в файлах логов по ключевым словам или регулярным выражениям. Поддерживается поиск в одном файле .log или во всем каталоге.

{
  "keywords": ["ERROR", "timeout"],
  "regex": "connection.*failed",
  "logPath": "/var/log",
  "limit": 100
}

count_by_level

Подсчет записей логов по уровню важности, с опциональной фильтрацией по временному диапазону.

{
  "logPath": "/var/log",
  "startTime": "2026-04-29T00:00:00Z",
  "endTime": "2026-04-30T00:00:00Z"
}

query_by_timerange

Фильтрация логов в заданном временном диапазоне с опциональным фильтром по уровню.

{
  "startTime": "2026-04-29T00:00:00Z",
  "endTime": "2026-04-30T00:00:00Z",
  "logPath": "/var/log",
  "level": "ERROR",
  "limit": 100
}

get_system_metrics

Получение метрик ЦП, памяти и диска. Поддерживаются Windows и Linux.

{
  "metrics": ["cpu", "memory", "disk"]
}

explain_error

Форматирование содержимого ошибки для анализа первопричин с помощью ИИ.

{
  "errorContent": "java.lang.NullPointerException\n  at com.example.Service.process(Service.java:42)",
  "contextLines": 10
}

Архитектура

src/
├── index.ts           # MCP Server entry point
├── tools/             # Individual MCP tool implementations
├── utils/
│   ├── log_parser.ts  # Timestamp/level parsing, keyword/regex matching
│   └── metrics.ts     # Cross-platform CPU/memory/disk metrics
└── types/             # TypeScript type definitions

Сервер использует @modelcontextprotocol/sdk с StdioServerTransport. Инструменты регистрируются через обработчик CallToolRequestSchema.

Ключевые проектные решения

• Потоковая обработка: Использует readline + createReadStream для обработки больших файлов логов без полной загрузки в память

• Кроссплатформенность: Реализация с двумя путями для Windows (WMIC) и Linux (top/free/df) с определением платформы во время выполнения

• Толерантный парсинг: Нестандартные форматы логов сохраняются, а не отбрасываются (отсутствующие уровни по умолчанию считаются INFO, отсутствующие временные метки — текущим временем)

Лицензия

MIT