{
  "markdown": "\n# @rog0x/mcp-log-tools\n\nLog analysis and processing tools for AI agents, exposed via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).\n\n## Tools\n\n### parse_logs\n\nParse 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.\n\n### filter_logs\n\nFilter parsed log entries by:\n\n- Log level (ERROR, WARN, INFO, DEBUG)\n- Date range (ISO 8601)\n- Keyword search (case-insensitive)\n- Regex pattern matching\n- Source/logger name\n\nReturns matched entries along with level occurrence counts.\n\n### analyze_logs\n\nAnalyze log patterns to surface operational insights:\n\n- Top 10 most frequent errors (normalized)\n- Error rate over time (hourly buckets)\n- Request volume per hour\n- Slowest endpoints (from HTTP access logs)\n- Anomaly detection (sudden spikes or drops using standard deviation)\n\n### format_logs\n\nConvert between log formats and produce reports:\n\n- JSON to plain text, plain to JSON, CSV, or table\n- ANSI colorization by log level\n- Structured field extraction\n- Summary report generation\n\n### log_stats\n\nCompute comprehensive log statistics:\n\n- Total and non-empty line counts\n- Level distribution with percentages\n- Date range coverage\n- Unique IP addresses and request counts\n- Top user agents\n- HTTP status code distribution\n- Throughput (entries per second)\n\n## Setup\n\n```bash\nnpm install\nnpm run build\n```\n\n## Usage with Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"log-tools\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/mcp-log-tools/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Supported Log Formats\n\n| Format | Example |\n|--------|---------|\n| JSON | `{\"timestamp\":\"2024-01-15T10:30:00Z\",\"level\":\"ERROR\",\"message\":\"Connection failed\"}` |\n| Apache/Nginx | `127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] \"GET /index.html HTTP/1.1\" 200 2326` |\n| Syslog | `Jan  1 00:00:00 hostname process[1234]: Something happened` |\n| Structured | `2024-01-15T10:30:00.000Z [ERROR] [ModuleName] Something failed` |\n| Custom | Any format using a regex with named capture groups |\n\n## License\n\nMIT\n",
  "bytes": 2229,
  "sha": "ba843816a1e8da764ba8689b4f4ca0ad6f4d012d8912c5d274d65351c6a16ee1",
  "repo_slug": "rog0x/mcp-log-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rog0x_log_2c07f0e7/readme"
}