System Diagnostics

Know Your Computer (KYC) MCP Server provides comprehensive system diagnostics and monitoring, giving you detailed hardware information, live performance metrics, and optimization recommendations so you can keep your machines healthy and performant across Windows, macOS, and Linux.

How to use

You interact with the MCP server through a client that supports MCP connections. After you configure the client to connect to the system diagnostics MCP, you can request real-time system information, monitor CPU/memory/storage/network usage, review running processes and installed applications, inspect BIOS/motherboard details, and receive hardware upgrade recommendations. Use natural language prompts to ask for status updates, performance analyses, bottleneck checks, battery status (laptops), and targeted hardware guidance. You can also retrieve system logs and compare current metrics against baseline thresholds to spot anomalies.

Common usage patterns include asking for the current system status, requesting CPU and memory usage, checking available disk space, identifying top-resource-consuming processes, and obtaining hardware recommendations for upgrades. You can query for specific components such as motherboard details, BIOS version, RAM slots, and supported memory types, as well as battery health and power usage on laptops.

How to install

Prerequisites you need before installation are Python 3.8 or higher and the pip package manager.

Basic installation steps you should follow in sequence are:

# Clone the repository
# Note: replace with the actual repository URL when you perform the clone
# git clone https://github.com/yourusername/system-diagnostics-mcp.git
# cd system-diagnostics-mcp

# Create a virtual environment
python -m venv venv

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

# Install dependencies
pip install -r requirements.txt

Additional sections

Configuration details show how to wire the MCP server to Claude Desktop so you can issue natural language requests from the interface. You set up a local stdio-based MCP server that runs a Python module inside your virtual environment.

Security considerations emphasize that the server only reads system information, does not collect passwords or keys, and only processes metadata for network connections. Access control and appropriate permissions should be used to protect your data.

Troubleshooting common issues includes resolving Python package problems (such as psutil), ensuring correct WMI dependencies on Windows, and running with sufficient privileges when you encounter permission errors. If MCP connection issues arise, verify the configured path to your virtual environment, activate the environment, and ensure the server starts without errors.

Available tools

get_system_info

Comprehensive system information such as OS, hardware specs, uptime, and serials.

get_computer_model

Manufacturer, model, and system details including vendor and product information.

get_motherboard_details

Motherboard specifications, BIOS/UEFI details, memory slots, and hardware capabilities.

get_cpu_metrics

CPU usage, frequency, temperature, and per-core statistics.

get_memory_metrics

Memory usage, swap usage, and per-process memory consumption.

get_storage_metrics

Storage devices, usage statistics, I/O stats, and drive type (SSD/HDD).

get_network_metrics

Network interfaces, connections, and traffic analysis.

get_processes

Running processes and their resource consumption.

get_installed_applications

List of installed applications on the system.

get_battery_status

Battery health and power usage for laptops.

get_system_logs

Recent system logs and events for diagnostics.

diagnose_performance

Performance analysis and bottleneck identification.

get_hardware_recommendations

Upgrade suggestions based on usage patterns.