Comprehensive system diagnostics and monitoring server providing detailed hardware information, performance metrics, and optimization recommendations.

• Tools: 12 diagnostic tools including CPU, memory, storage, network, processes, applications, battery, motherboard details, and performance analysis
• Resources: System metrics, hardware specifications, and real-time monitoring data
• Platform: Cross-platform (Windows, macOS, Linux)
• Repository

• System Information: OS detection, hardware specs, uptime
• Computer Model Detection: Manufacturer, model, system specifications
• Motherboard Details: Motherboard info, BIOS/UEFI, memory slots, hardware capabilities
• CPU Metrics: Usage, frequency, temperature, per-core statistics
• Memory Monitoring: RAM/swap usage, process memory consumption
• Storage Analysis: Disk usage, I/O stats, SSD/HDD detection
• Network Monitoring: Interface stats, active connections, traffic analysis
• Process Management: Running processes, resource consumption
• Application Inventory: Installed applications listing
• Battery Status: Power consumption, battery health (laptops)
• System Logs: Event logs, system messages
• Performance Diagnostics: Bottleneck detection, performance analysis
• Hardware Recommendations: Upgrade suggestions based on usage patterns

• ✅ Windows (10, 11)
• ✅ macOS (10.15+)
• ✅ Linux (Ubuntu, Debian, RHEL, etc.)

• Python 3.8 or higher
• pip package manager

# Clone the repository
git clone https://github.com/yourusername/system-diagnostics-mcp.git
cd system-diagnostics-mcp

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

For Windows systems, install additional dependencies:

pip install wmi pywin32

Add the following to your Claude Desktop configuration file:

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "system-diagnostics": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["-m", "system_diagnostics_mcp.server"],
      "cwd": "C:\\path\\to\\system-diagnostics-mcp",
      "env": {
        "PYTHONPATH": "C:\\path\\to\\system-diagnostics-mcp"
      }
    }
  }
}

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "system-diagnostics": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "system_diagnostics_mcp.server"],
      "cwd": "/path/to/system-diagnostics-mcp",
      "env": {
        "PYTHONPATH": "/path/to/system-diagnostics-mcp"
      }
    }
  }
}

Edit ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "system-diagnostics": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "system_diagnostics_mcp.server"],
      "cwd": "/path/to/system-diagnostics-mcp",
      "env": {
        "PYTHONPATH": "/path/to/system-diagnostics-mcp"
      }
    }
  }
}

Once configured, you can interact with the system diagnostics server through Claude:

"What's my current system status?"
"Show me CPU and memory usage"
"How much disk space do I have left?"

"My system is running slow, can you diagnose why?"
"Which applications are using the most memory?"
"Are there any performance bottlenecks?"

"Why is my battery draining so fast?"
"Which apps are consuming the most power?"
"What's my current battery status?"

"I want to upgrade my system for gaming, what should I upgrade?"
"What hardware changes would improve my development workflow?"
"Should I add more RAM or upgrade my CPU?"

"What applications are installed on my system?"
"Show me all running processes sorted by CPU usage"
"Which processes are using network bandwidth?"

"What motherboard do I have?"
"What's my computer model and manufacturer?"
"How many RAM slots does my motherboard have?"
"What's the maximum RAM my system supports?"
"What BIOS version am I running?"
"Can I add more RAM to my system?"
"What memory slots are currently occupied?"
"Show me my motherboard specifications"
"What's my system's serial number?"
"What type of memory does my system use (DDR3/DDR4/DDR5)?"

Some features may require elevated permissions:

• Windows: Run as Administrator for complete system access
• macOS: Grant Terminal/Python full disk access in System Preferences
• Linux: Some features may require sudo access

1. ImportError for psutil

   pip install --upgrade psutil

2. Windows: WMI errors

   pip install --upgrade wmi pywin32

3. Permission denied errors

   • Run with appropriate privileges
   • Check file system permissions

4. MCP connection issues

   • Verify the path in Claude Desktop config
   • Ensure Python virtual environment is activated
   • Check that the server starts without errors

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.

• The server has read-only access to system information
• No sensitive data (passwords, keys) is collected
• Network monitoring shows only connection metadata
• Application listing doesn't include user data

MIT License - See LICENSE file for details

• Built on the Model Context Protocol (MCP) by Anthropic
• Uses psutil for cross-platform system monitoring
• Inspired by various system monitoring tools"