Secure File & Log Analyzer MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Secure File & Log Analyzer MCP Server
A production-grade, security-hardened Model Context Protocol (MCP) server built with Python and FastMCP. This server exposes a curated catalog of log analysis tools to AI agents while implementing strict input validation, OS-level symlink/TOCTOU mitigation, streaming resource protection, and dynamic response redaction.
π οΈ Exposed MCP Tools
list_log_files
Lists the regular files in the configured safe directory (defaults to./mock_logs/), sorted alphabetically.view_log_summary
Reads a requested log file and returns its size, line count, and a brief preview.search_error_patterns
Streams and searches a given log file for matching keywords (e.g.,"CRITICAL","ERROR"), returning matching lines with line numbers.
Related MCP server: Error Analyzer MCP Server
π Security Posture & Threat Model
This codebase relies on defense-in-depth. For a complete analysis of assets and attackers, see docs/THREAT_MODEL.md.
Threat / Attack Vector | Mitigation Strategy | Implementation Details |
Path Traversal | Blocks access to system files ( | 1. Input allowlist ( |
Symlink / TOCTOU | Prevents race condition swapping. | 1. Opens files using |
Shell Injection | Blocks OS command chaining. | 1. Reads files natively in Python.2. Sanitizes keywords against shell metacharacters. |
Data Leakage | Prevents token exfiltration. | 1. Real-time regex redaction engine.2. Masks API keys, JWTs, and AWS credentials. |
Resource Exhaustion | Prevents DoS and OOM crashes. | 1. Line-by-line file streaming.2. Configuration limits on file size and search payload. |
βοΈ Configuration
The server is configured using environment variables. If not provided, secure defaults are applied:
Environment Variable | Description | Default Value |
| The absolute or relative path to the safe logs folder. |
|
| Maximum file size (in bytes) that the server is allowed to process. |
|
| Number of lines returned in the log preview. |
|
| Maximum number of matching lines returned in a search. |
|
| Maximum character length of the search result response payload. |
|
π Getting Started
Prerequisites
Python 3.10 or higher.
On some systems, use
python3andpip3instead ofpythonandpip.
Installation
Clone the repository and navigate to the root directory.
Create and activate a virtual environment:
python -m venv .venv # On Windows (PowerShell): .\.venv\Scripts\Activate.ps1 # On Unix/macOS: source .venv/bin/activateInstall dependencies:
pip install -r requirements.txt
Running Tests
Run the comprehensive unit test suite to verify security guards and tools functionality:
python -m unittest discover -s testsπ Connecting to MCP Clients
1. Claude Desktop
To add this server to Claude Desktop, edit your claude_desktop_config.json (located at %APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add the server definition:
{
"mcpServers": {
"secure-log-analyzer": {
"command": "C:\\absolute\\path\\to\\.venv\\Scripts\\python.exe",
"args": [
"C:\\absolute\\path\\to\\mcp-trust-layer\\src\\secure_log_analyzer\\server.py"
],
"env": {
"LOG_ANALYZER_BASE_DIR": "C:\\absolute\\path\\to\\mcp-trust-layer\\mock_logs",
"LOG_ANALYZER_MAX_FILE_SIZE": "52428800"
}
}
}
}Make sure to adjust the absolute paths to the python executable and theserver.py file to match your local installation.
2. MCP Inspector (Debugging Tool)
You can run and inspect the server using the MCP Inspector tool:
npx -y @modelcontextprotocol/inspector C:\absolute\path\to\\.venv\Scripts\python.exe C:\absolute\path\to\mcp-trust-layer\src\secure_log_analyzer\server.pyOpen the URL output in your terminal to interactively call the tools and test validations.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
Read-only access to Auralogs production logs: search logs, inspect errors, review AI analyses.
Read LogBrew errors, slow traces, logs, and product analytics, and triage issues with consent.
Security log tools: Windows/Entra error codes, log explainer, IP blocklists, attack scans
Search log events, investigate anomalies, and manage cases in your Knowledge Grid tenant.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to automatically inspect and analyze application runtime log files for debugging and troubleshooting. Supports monitoring multiple log directories simultaneously with tools for listing, reading, searching, and paginating through log files.840 PyPIMIT
- FlicenseNot gradedqualityDmaintenanceAnalyzes log files to identify root causes of project errors and generates detailed fix plans with risk assessments. It implements a multi-phase workflow that ensures no code modifications are applied without explicit user approval.-
- FlicenseNot gradedqualityDmaintenanceHandles log file management and analysis with tools to list, read, search, filter, and generate analytics on log files.1-
- AlicenseNot gradedqualityFmaintenanceEnables LLMs to analyze logs by extracting patterns, redacting secrets, and providing token-efficient summaries from files, Docker containers, or journald.5MIT