log-analyzer-mcp

Ein MCP-Server (Model Context Protocol), der Tools zur Protokollanalyse und für Systemmetriken bereitstellt. Er verbindet sich über den stdio-Transport mit Claude Code und stellt 5 Tools zum Suchen, Zählen und Analysieren lokaler Protokolldateien zur Verfügung.

Funktionen

Schnellstart

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run the server
npm start

Entwicklung

# Run with hot reload
npm run dev

Integration mit Claude Code

Fügen Sie den Server zu Claude Code hinzu:

# 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

Überprüfen Sie die Verbindung:

claude mcp list

Tool-Details

search_logs

Durchsuchen Sie Protokolldateien nach Schlüsselwörtern oder Regex. Unterstützt die Suche in einer einzelnen .log-Datei oder einem gesamten Verzeichnis.

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

count_by_level

Zählen Sie Protokolleinträge nach Schweregrad, optional gefiltert nach Zeitbereich.

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

query_by_timerange

Filtern Sie Protokolle innerhalb eines bestimmten Zeitbereichs, mit optionalem Filter für den Schweregrad.

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

get_system_metrics

Abrufen von CPU-, Arbeitsspeicher- und Festplattenmetriken. Unterstützt Windows und Linux.

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

explain_error

Formatieren Sie Fehlerinhalte für eine KI-gestützte Ursachenanalyse.

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

Architektur

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

Der Server verwendet @modelcontextprotocol/sdk mit StdioServerTransport. Tools werden über den CallToolRequestSchema-Handler registriert.

Wichtige Designentscheidungen

• Stream-Verarbeitung: Verwendet readline + createReadStream, um große Protokolldateien zu verarbeiten, ohne sie vollständig in den Arbeitsspeicher zu laden

• Plattformübergreifend: Implementierung mit zwei Pfaden für Windows (WMIC) und Linux (top/free/df) mit Laufzeit-Plattformerkennung

• Tolerantes Parsing: Nicht standardmäßige Protokollformate bleiben erhalten, anstatt verworfen zu werden (fehlende Ebenen werden standardmäßig auf INFO gesetzt, fehlende Zeitstempel auf die aktuelle Zeit)

Lizenz

MIT