This server allows you to read, analyze, and debug MCP logs with the following capabilities:
Read logs from standard locations across macOS, Windows, and Linux
Filter log entries using case-insensitive text searches
Paginate through large log collections efficiently
Limit processed lines to control the amount of data read from each file
Customize log directory by specifying a custom path when needed
Set file limits per page for efficient browsing
Integrate seamlessly with Claude Desktop
MCP Server: Analyze & Debug MCP Logs
๐ฏ Overview
MCP Log Reader is a specialized MCP server that helps you analyze and debug Model Context Protocol logs. It provides Claude with direct access to log files, making it easy to troubleshoot MCP integrations and understand how Claude interacts with your tools.
Multi-platform Support: Works on macOS, Windows, and Linux with platform-specific log paths
Smart Filtering: Find specific log entries with case-insensitive text search
Paginated Browsing: Navigate large log collections efficiently
Size Management: Handles large log files with intelligent truncation
Seamless Claude Integration: Works directly with Claude Desktop
Related MCP server: MCP Easy Copy
๐ Quick Start
Installing via Smithery
To install MCP Log Reader for Claude Desktop automatically via Smithery:
Installing Manually
Install directly from GitHub:
Build and run:
๐ Connecting to Claude
Add the server to your Claude Desktop configuration:
Then restart Claude Desktop.
๐ Available Parameters
The log reader supports these parameters:
Parameter | Description | Default |
| Number of lines to read from each log file | 100 |
| Text to filter log entries by (case-insensitive) | "" |
| Custom path to log directory | OS-specific |
| Maximum number of files to read per page | 5 |
| Page number for pagination | 1 |
๐ก Example Usage
Ask Claude to use the log reader tool:
Or with specific parameters:
โ๏ธ How It Works
The server automatically detects your OS and finds the appropriate log directory
It locates all MCP log files and sorts them by modification time (newest first)
The requested page of log files is retrieved based on pagination settings
Files are processed with size limits to prevent overwhelming responses
Filtered content is returned in a structured format with pagination details
๐ License
MIT License