Getting Started

Welcome to Troubleshooting MCP Server. Get up and running in under 5 minutes.

Quick Start Guide

Prerequisites

Python 3.8 or higher
Claude Desktop or compatible MCP client
Terminal/Command Prompt access

30-Second Installation

Option 1: uvx (Recommended)

uvx troubleshooting-mcp-server test

✅ No installation required • ✅ Automatic dependencies • ✅ Always latest

Option 2: Traditional pip

pip install troubleshooting-mcp-server
troubleshooting-mcp-server test

Configure Claude Desktop

Locate your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.jsonLinux: ~/.config/Claude/claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "troubleshooting": {
      "command": "uvx",
      "args": ["troubleshooting-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

First Commands to Try

"Check my system information"
"Show current resource usage"
"Test network connectivity to google.com"
"Find log files for node applications"

System Requirements

Supported Platforms

Platform	Version	Status
macOS	10.15+	✅ Full Support
Linux	Ubuntu 18.04+, CentOS 7+	✅ Full Support
Windows	Windows 10+	⚠️ Limited Support

Python Requirements

Minimum: Python 3.8
Recommended: Python 3.11+
Dependencies: Only mcp>=1.0.0

Hardware Requirements

RAM: 50MB minimum
Disk: 10MB installation
Network: Optional (for connectivity tests)
Permissions: Read access to system logs

First Steps

After installation, try these commands to explore the capabilities:

"Check my system information"

Get OS, hardware, and Python details

"Show current resource usage"

View CPU, memory, and disk usage

"Find log files for node"

Locate Node.js application logs

"Test network connectivity"

Verify internet connectivity

Documentation