trackmcp
Back to directory
mfreeman451

json-logs-mcp-server

View on GitHub

MCP server for Python JSON logs

4 stars PythonServers & Infrastructure Updated Aug 24, 2025
jsonlogsmcpmcp-server

Documentation

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:

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

2. Create a virtual environment:

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

3. Install the package:

bash
pip install -e .

4. Create the wrapper script:

bash
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

Frequently asked questions

What is json-logs-mcp-server?

json-logs-mcp-server is MCP server for Python JSON logs

How do I install json-logs-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is json-logs-mcp-server open source?

Yes โ€” it is hosted on GitHub at https://github.com/mfreeman451/json-logs-mcp-server and has 4 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP