Advertise
MCP.so
Sign In

JSON Logs MCP Server

@mfreeman451

Repository

Basic information

Category

Developer Tools

License

MIT-0

Transports

stdio

Author

mfreeman451

About JSON Logs MCP Server

MCP server for Python JSON logs

#json#mcp#logs#mcp-server

JSON Logs MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "json-logs": {
      "command": "python",
      "args": [
        "/Users/mfreeman/src/nco/json_logs_mcp_server.py"
      ],
      "cwd": "/Users/mfreeman/src/nco"
    }
  }
}

JSON Logs MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 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. It provides tools for searching, filtering, aggregating, and analyzing structured log data.

How to use JSON Logs MCP Server?

Clone the repository, create a virtual environment, install the package, create a wrapper script, and set the MCP_JSON_LOGS_DIR environment variable to point to your log directory. Add the server to Claude Desktop’s configuration file under mcpServers. Once configured, interact with your logs through Claude Desktop by asking questions like “Show me all ERROR logs from today” or “Group logs by level”.

Key features of JSON Logs MCP Server

  • Browse and list JSON log files with metadata
  • Search logs by level, module, function, message content, and time range
  • Aggregate log data by level, module, function, or hour
  • Get comprehensive statistics about log files
  • On-demand loading optimized for large log files

Use cases of JSON Logs MCP Server

  • Finding all ERROR and CRITICAL logs from the last hour
  • Analyzing which module generates the most warnings
  • Debugging database connection errors by examining context
  • Getting a breakdown of log levels across all files
  • Investigating authentication failures in a specific time window

Frequently asked questions

1

Why won't the server start?

Ensure Python 3.8+ is installed, all dependencies are installed (`pip install -e .`), and the log directory exists and contains `.log` files.

2

Tools are not appearing in Claude Desktop?

Restart Claude Desktop after configuration changes, check the "Connect Apps" section, look for error messages in the developer console, and verify the server shows as "Connected".

3

No logs are found?

Verify log files exist in the configured directory, have a `.log` extension, are in the correct JSON format (one JSON object per line), and contain all required fields (timestamp, level, message, module, function, line).

4

I get a "spawn python ENOENT" error?

Use `python3` instead of `python` in your configuration, provide the full absolute path to the wrapper script, and ensure the wrapper script is executable (`chmod +x run-json-logs-server.sh`).

5

How are large log files handled?

Log files are loaded on-demand, not all at once. Large files (>100MB) may take a moment to process. Use the `limit` parameter in queries to control result size. Consider rotating log files to maintain performance.

Comments

More Developer Tools MCP servers

Meticulous

Meticulous

Routebase

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

32

DocBin

DocBin

Give an agent a place to put large output. Instead of returning 40k characters of a build log into the conversation, it posts the file to DocBin and hands back one short URL. Docs render with syntax highlighting and mark

NextBlock CMS

NextBlock

Open-source Next.js + Supabase CMS with a per-site MCP server: scaffold a site, then create pages, posts, navigation, media and SEO from Claude, Cursor or any MCP client. Streamable HTTP with a bearer token you mint in y

Advertise