Available as an npm package for installation and dependency management, enabling easy deployment and integration into Node.js-based MCP ecosystems.
MCP Logs Assistant
Centralized logging and monitoring for the MCP ecosystem.
Overview
The Logs Assistant provides comprehensive logging and aggregation capabilities for all MCP services with integrated analytics.
Features
Log Collection: Aggregate logs from all services with in-memory indexing
Real-time Tail: Follow logs in real-time
Advanced Search: Query logs by service, level, time, correlation ID, or content
Time Aggregation: Aggregate logs by minute, hour, or day with statistics
Error Analysis: Analyze error patterns and trends across services
Service Health: Monitor service health based on log metrics
Anomaly Detection: Detect unusual patterns or spikes in log activity
Correlation Tracking: Trace requests across services with correlation IDs
Export: Export logs to JSON, CSV, or text formats
Rotation & Cleanup: Automatic log rotation and retention management
Installation
Usage
As MCP Server (Claude Desktop)
Configure in Claude Desktop settings:
As HTTP Service
The service will be available at http://localhost:9103
Available Tools
tail_logs
Follow logs in real-time from specified services.
search_logs
Search through logs with advanced filtering.
get_log_stats
Get statistics about logs.
rotate_logs
Manually trigger log rotation.
get_errors
Get recent errors across services.
clear_logs
Clear old logs based on retention policy.
Aggregation Tools
aggregate_logs
Aggregate logs by time period with statistics.
analyze_errors
Analyze error patterns and trends.
get_log_statistics
Get comprehensive log statistics.
find_correlated_logs
Find all logs with a specific correlation ID.
export_logs
Export filtered logs to file.
get_service_health
Analyze service health based on logs.
detect_anomalies
Detect anomalies in log patterns.
cleanup_old_logs
Clean up logs older than retention period.
Configuration
Aggregator Options
Environment Variables
Log Format
All services should use structured logging:
Data Storage
Service logs:
~/Documents/mcp-assistant/logs/[service-name]/
Aggregated data:
~/Documents/mcp-assistant/data/logs-assistant/aggregated/
Exported logs:
~/Documents/mcp-assistant/data/logs-assistant/aggregated/export-*.{json,csv,text}
In-memory indices: Service, Correlation ID, Error Type
Development
Performance Features
Indexing
Builds indices on startup for fast queries
Updates indices incrementally every minute
Maintains separate indices for services, correlations, and errors
Limits in-memory cache to prevent memory issues
Query Optimization
Uses indexed lookups for common queries
Supports time-range filtering
Implements result pagination
Caches frequently accessed data
Use Cases
Troubleshooting Service Issues
Request Tracing
Performance Monitoring
Troubleshooting
Slow Queries
Reduce time range
Add more specific filters
Increase cache size if memory allows
Missing Logs
Check if logs are in expected format
Verify log directory paths
Ensure services are writing logs correctly
High Memory Usage
Reduce maxMemoryLogs setting
Implement more aggressive retention policies
Use export and cleanup features regularly
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Provides comprehensive logging and monitoring capabilities for MCP services with real-time log tailing, advanced search, error analysis, and anomaly detection. Enables centralized log aggregation, correlation tracking, and health monitoring across all MCP ecosystem services.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that allows AI assistants to access AWS CloudWatch logs by listing log groups and reading log entries.Last updated -25
- AsecurityAlicenseAqualityA specialized MCP server that helps analyze and debug Model Context Protocol logs by providing Claude with direct access to log files across multiple platforms.Last updated -113MIT License
- -securityFlicense-qualityA simplified MCP server that provides a streamlined way to interact with AWS CloudWatch resources (log groups, log queries, and alarms) through the MCP protocol.Last updated -4
- -securityFlicense-qualityAn MCP server that enables interaction with Google Cloud Logging API, allowing users to write, read, and manage log entries and configurations through natural language.Last updated -