JSON Logs MCP Server

@mfreeman451

代码仓库

基本信息

分类

开发工具

许可证

MIT-0

传输方式

stdio

作者

mfreeman451

关于 JSON Logs MCP Server

MCP server for Python JSON logs

#json #mcp #logs #mcp-server

JSON Logs MCP Server 配置

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

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

JSON Logs MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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 服务器

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

Meticulous

Screen Browser

Turn a plain-language guide into a narrated walkthrough video of your deployed web app. Your coding agent can write the guide from the source and bring back the MP4.

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

Final POS – Custom POS Builder

Final Commerce

Build custom POS apps with your AI agent. Final's MCP server lets developers scaffold checkout flows, adapt vetted screen blueprints for counter POS, self-checkout kiosks, restaurant ordering and payment terminals, previ