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

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

Crawl Readiness

Grubbomatic

AI SEO tools for MCP clients — audit whether AI crawlers can read a website, validate JSON-LD and robots.txt, and generate llms.txt, AI-crawler-aware robots.txt, and JSON-LD schema without leaving the conversation.

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

1

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

1

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

1
Advertise