JSON Logs MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop (or any MCP client) to read and analyze JSON-formatted log files. This server provides tools for searching, filtering, aggregating, and analyzing structured log data.

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

Prerequisites

• Python 3.11 or higher
• Claude Desktop (or another MCP client)

Installation

1. Clone this repository:

git clone https://github.com/mfreeman451/json-logs-mcp-server.git
cd json-logs-mcp-server

2. Create a virtual environment:

python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install the package:

pip install -e .

4. Create the wrapper script:

cat > run-json-logs-server.sh 100MB) may take a moment to process
- Use the `limit` parameter in queries to control result size
- Consider rotating log files to maintain performance

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

MIT License - see LICENSE file for details