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

Nebelus

Nebelus

Nebelus is an enterprise agentic-AI platform for regulated industries. This MCP server exposes the Nebelus Construction API: ~48 tools that give an MCP client full agent build parity — create/update/probe agents, edit ag

Yocoolab

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools

1

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

31

UXKIN

Real UI references for AI coding agents: 500,000+ real screens, 15k+ website design systems with a DESIGN.md, and 30k+ UI elements, so your agent builds UI that looks real, not AI slop.

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

9
Advertise