Skip to main content
Glama
@rog0x/mcp-log-tools

@rog0x/mcp-log-tools

by rog0x

@rog0x/mcp-log-tools

Log analysis and processing tools for AI agents, exposed via the Model Context Protocol (MCP).

Tools

parse_logs

Parse log content in common formats: JSON logs, Apache/Nginx access logs, syslog, and structured logs. Supports custom regex patterns with named capture groups. Extracts timestamp, level, message, source, and additional structured fields.

filter_logs

Filter parsed log entries by:

  • Log level (ERROR, WARN, INFO, DEBUG)

  • Date range (ISO 8601)

  • Keyword search (case-insensitive)

  • Regex pattern matching

  • Source/logger name

Returns matched entries along with level occurrence counts.

analyze_logs

Analyze log patterns to surface operational insights:

  • Top 10 most frequent errors (normalized)

  • Error rate over time (hourly buckets)

  • Request volume per hour

  • Slowest endpoints (from HTTP access logs)

  • Anomaly detection (sudden spikes or drops using standard deviation)

format_logs

Convert between log formats and produce reports:

  • JSON to plain text, plain to JSON, CSV, or table

  • ANSI colorization by log level

  • Structured field extraction

  • Summary report generation

log_stats

Compute comprehensive log statistics:

  • Total and non-empty line counts

  • Level distribution with percentages

  • Date range coverage

  • Unique IP addresses and request counts

  • Top user agents

  • HTTP status code distribution

  • Throughput (entries per second)

Related MCP server: log-mcp-server

Setup

npm install
npm run build

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "log-tools": {
      "command": "node",
      "args": ["path/to/mcp-log-tools/dist/index.js"]
    }
  }
}

Supported Log Formats

Format

Example

JSON

{"timestamp":"2024-01-15T10:30:00Z","level":"ERROR","message":"Connection failed"}

Apache/Nginx

127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /index.html HTTP/1.1" 200 2326

Syslog

Jan 1 00:00:00 hostname process[1234]: Something happened

Structured

2024-01-15T10:30:00.000Z [ERROR] [ModuleName] Something failed

Custom

Any format using a regex with named capture groups

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides comprehensive logging and monitoring capabilities for MCP services with real-time log tailing, advanced search, error analysis, and anomaly detection. Enables centralized log aggregation, correlation tracking, and health monitoring across all MCP ecosystem services.
      -
    • F
      license
      B
      quality
      D
      maintenance
      A log analysis MCP server that enables tailing, searching, filtering, and summarizing logs from local files and Docker containers.
      7
      -
    • A
      license
      Not graded
      quality
      F
      maintenance
      Exposes configured log files as MCP tools, enabling agents to list, query, and follow logs from local and SSH sources.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for collecting and analyzing CLI/web server error logs. Enables watching log files/directories, parsing common error patterns, and querying/analyzing logs through natural language.
      -