MCP 服务器

KYC MCP Server

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

README

System Diagnostics MCP Server

Know Your Computer (KYC) MCP Server

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

Features

Core Monitoring Capabilities

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

Platform Support

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

Installation

Prerequisites

Python 3.8 or higher
pip package manager

Basic Installation

# 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

Windows Additional Setup

For Windows systems, install additional dependencies:

pip install wmi pywin32

Configuration

Claude Desktop Configuration

Add the following to your Claude Desktop configuration file:

Windows

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"
      }
    }
  }
}

macOS

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"
      }
    }
  }
}

Linux

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"
      }
    }
  }
}

Usage Examples

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

Basic System Check

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

Performance Analysis

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

Battery and Power (Laptops)

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

Hardware Recommendations

"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?"

Application Management

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

Hardware and System Information

"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)?"

Available Tools

Tool Name	Description
`get_system_info`	Comprehensive system information
`get_computer_model`	Computer manufacturer, model, and system details
`get_motherboard_details`	Motherboard specifications, BIOS info, and memory slots
`get_cpu_metrics`	Detailed CPU metrics and temperature
`get_memory_metrics`	Memory usage and top consumers
`get_storage_metrics`	Storage devices and usage
`get_network_metrics`	Network interfaces and connections
`get_processes`	Running processes information
`get_installed_applications`	List of installed applications
`get_battery_status`	Battery and power information
`get_system_logs`	Recent system logs and events
`diagnose_performance`	Performance analysis and bottlenecks
`get_hardware_recommendations`	Hardware upgrade suggestions

Permissions

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

Troubleshooting

Common Issues

ImportError for psutil
```
pip install --upgrade psutil
```
Windows: WMI errors
```
pip install --upgrade wmi pywin32
```
Permission denied errors
- Run with appropriate privileges
- Check file system permissions
MCP connection issues
- Verify the path in Claude Desktop config
- Ensure Python virtual environment is activated
- Check that the server starts without errors