json-logs-mcp-server

mfreeman451/json-logs-mcp-server

3.3

If you are the rightful owner of json-logs-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server designed to facilitate the reading and analysis of JSON-formatted log files.

The JSON Logs MCP Server is a specialized server that enables MCP clients, such as Claude Desktop, to efficiently read, search, filter, and analyze JSON-formatted log files. This server is optimized for handling large log files and provides a suite of tools for querying and aggregating structured log data. It supports browsing log files, searching by various criteria, aggregating data, and generating comprehensive statistics. The server is designed to be fast and efficient, making it suitable for environments with extensive logging needs. It requires Python 3.11 or higher and can be easily integrated with Claude Desktop or other MCP clients. The server expects log files to be in a specific JSON format, ensuring consistency and reliability in log data processing.

Features

  • Browse log files: List and read JSON-formatted log files.
  • Search and filter: Query logs by level, module, function, message content, and time range.
  • Aggregate data: Group and analyze logs by various criteria.
  • Statistics: Get comprehensive statistics about your log data.
  • Fast and efficient: Optimized for handling large log files.

Usages

usage with Claude Desktop

{
  "mcpServers": {
    "json-logs": {
      "command": "/absolute/path/to/run-json-logs-server.sh",
      "args": [],
      "env": {
        "MCP_JSON_LOGS_DIR": "/path/to/your/logs"
      }
    }
  }
}

Tools

  1. list_log_files

    Lists all available log files with metadata.

  2. query_logs

    Search and filter log entries based on various parameters.

  3. aggregate_logs

    Aggregate log data by specified criteria.

  4. get_log_stats

    Get comprehensive statistics about log files.