Back to Home
tblakex01 icon

mcp_troubleshooter

Verified Safe

by tblakex01

Overview

A Model Context Protocol (MCP) server that provides comprehensive system troubleshooting and diagnostic tools for developers and system administrators, enabling LLMs to diagnose system issues, monitor resources, check logs, and test connectivity.

Installation

Run Command
troubleshooting-mcp

Environment Variables

  • PYTHONPATH
  • LOG_LEVEL
  • PATH

Security Notes

The project demonstrates a strong "Security First" design principle. It implements a strict command whitelist (`SAFE_COMMANDS`) for `troubleshooting_execute_safe_command`, preventing arbitrary code execution. All inputs are rigorously validated using Pydantic models with type checking, range constraints, and pattern validation. Critical operations include timeout protection to prevent denial of service. The `log_reader` tool enforces access restrictions to `ALLOWED_LOG_DIRS` and uses `Path.resolve()` to mitigate path traversal vulnerabilities. Environment variables containing sensitive patterns are masked during inspection. While the security measures are robust for its intended diagnostic purpose, the inherent risk of running any system commands via an LLM, even whitelisted ones, means vigilance is always required.

Similar Servers

Stats

Interest Score30
Security Score9
Cost ClassHigh
Avg Tokens1000
Stars1
Forks0
Last Update2026-01-17

Tags

troubleshootingdiagnosticssystem monitoringMCP serverLLM tools