JSON Logs MCP Server

Name: JSON Logs MCP Server
Author: mfreeman451

@mfreeman451

代码仓库

关于 JSON Logs MCP Server

MCP server for Python JSON logs

#json #mcp #logs #mcp-server

基本信息

分类

开发工具

许可证

MIT-0

运行时

python

传输方式

stdio

发布者

mfreeman451

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

FAQ from JSON Logs MCP Server

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.

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".

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).

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).

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.

开发工具分类下的更多 MCP 服务器

Golf

golf-mcp

Production-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents

834